Open Geospatial Consortium |
Submission Date: <yyyy-mm-dd> |
Approval Date: <yyyy-mm-dd> |
Publication Date: <2020-09-22> |
External identifier of this OGC® document: http://www.opengis.net/doc/IS/CityGML-1/3.0 |
Internal reference number of this OGC® document: 20-010 |
Version: 0.9 |
Category: OGC® Conceptual Model |
Editors: Thomas H. Kolbe, Tatjana Kutzner, Carl Stephen Smyth, Claus Nagel, Carsten Roensdorf, Charles Heazel |
OGC City Geography Markup Language (CityGML) Part 1: Conceptual Model Standard |
Copyright notice |
Copyright © 2020 Open Geospatial Consortium |
To obtain additional rights of use, visit http://www.opengeospatial.org/legal/ |
Warning |
This document is not an OGC Standard. This document is distributed for review and comment. This document is subject to change without notice and may not be referred to as an OGC Standard.
Recipients of this document are invited to submit, with their comments, notification of any relevant patent rights of which they are aware and to provide supporting documentation.
Document type: OGC® Standard |
Document subtype: Conceptual Model |
Document stage: Draft |
Document language: English |
License Agreement
Permission is hereby granted by the Open Geospatial Consortium, ("Licensor"), free of charge and subject to the terms set forth below, to any person obtaining a copy of this Intellectual Property and any associated documentation, to deal in the Intellectual Property without restriction (except as set forth below), including without limitation the rights to implement, use, copy, modify, merge, publish, distribute, and/or sublicense copies of the Intellectual Property, and to permit persons to whom the Intellectual Property is furnished to do so, provided that all copyright notices on the intellectual property are retained intact and that each person to whom the Intellectual Property is furnished agrees to the terms of this Agreement.
If you modify the Intellectual Property, all copies of the modified Intellectual Property must include, in addition to the above copyright notice, a notice that the Intellectual Property includes modifications that have not been approved or adopted by LICENSOR.
THIS LICENSE IS A COPYRIGHT LICENSE ONLY, AND DOES NOT CONVEY ANY RIGHTS UNDER ANY PATENTS THAT MAY BE IN FORCE ANYWHERE IN THE WORLD.
THE INTELLECTUAL PROPERTY IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE DO NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE INTELLECTUAL PROPERTY WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION OF THE INTELLECTUAL PROPERTY WILL BE UNINTERRUPTED OR ERROR FREE. ANY USE OF THE INTELLECTUAL PROPERTY SHALL BE MADE ENTIRELY AT THE USER’S OWN RISK. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR ANY CONTRIBUTOR OF INTELLECTUAL PROPERTY RIGHTS TO THE INTELLECTUAL PROPERTY BE LIABLE FOR ANY CLAIM, OR ANY DIRECT, SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM ANY ALLEGED INFRINGEMENT OR ANY LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR UNDER ANY OTHER LEGAL THEORY, ARISING OUT OF OR IN CONNECTION WITH THE IMPLEMENTATION, USE, COMMERCIALIZATION OR PERFORMANCE OF THIS INTELLECTUAL PROPERTY.
This license is effective until terminated. You may terminate it at any time by destroying the Intellectual Property together with all copies in any form. The license will also terminate if you fail to comply with any term or condition of this Agreement. Except as provided in the following sentence, no such termination of this license shall require the termination of any third party end-user sublicense to the Intellectual Property which is in force as of the date of notice of such termination. In addition, should the Intellectual Property, or the operation of the Intellectual Property, infringe, or in LICENSOR’s sole opinion be likely to infringe, any patent, copyright, trademark or other right of a third party, you agree that LICENSOR, in its sole discretion, may terminate this license without any compensation or liability to you, your licensees or any other party. You agree upon termination of any kind to destroy or cause to be destroyed the Intellectual Property together with all copies in any form, whether held by you or by any third party.
Except as contained in this notice, the name of LICENSOR or of any other holder of a copyright in all or part of the Intellectual Property shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Intellectual Property without prior written authorization of LICENSOR or such copyright holder. LICENSOR is and shall at all times be the sole entity that may authorize you or any third party to use certification marks, trademarks or other special designations to indicate compliance with any LICENSOR standards or specifications. This Agreement is governed by the laws of the Commonwealth of Massachusetts. The application to this Agreement of the United Nations Convention on Contracts for the International Sale of Goods is hereby expressly excluded. In the event any provision of this Agreement shall be deemed unenforceable, void or invalid, such provision shall be modified so as to make it valid and enforceable, and as so modified the entire Agreement shall remain in full force and effect. No decision, action or inaction by LICENSOR shall be construed to be a waiver of any rights or remedies available to it.
- 1. Introduction
- 2. Scope
- 3. Conformance
- 4. References
- 5. Terms and Definitions
- 6. Conventions
- 7. Overview of CityGML
- 8. CityGML UML Model
- 8.1. Structural Overview of Requirements Classes
- 8.2. Core
- 8.3. Appearance
- 8.4. City Furniture
- 8.5. City Object Group
- 8.6. Dynamizer
- 8.7. Generics
- 8.8. Land Use
- 8.9. Point Cloud
- 8.10. Relief
- 8.11. Transportation
- 8.12. Vegetation
- 8.13. Versioning
- 8.14. Water Body
- 8.15. Construction
- 8.16. Bridge
- 8.17. Building
- 8.18. Tunnel
- 9. CityGML Data Dictionary
- 10. Application Domain Extension (ADE)
- Annex A: Abstract Test Suite (Normative)
- A.1. Introduction
- A.2. Conformance Class Core
- A.3. Conformance Class Appearance
- A.4. Conformance Class CityFurniture
- A.5. Conformance Class CityObjectGroup
- A.6. Conformance Class Dynamizer
- A.7. Conformance Class Generics
- A.8. Conformance Class LandUse
- A.9. Conformance Class PointCloud
- A.10. Conformance Class Relief
- A.11. Conformance Class Transportation
- A.12. Conformance Class Vegetation
- A.13. Conformance Class Versioning
- A.14. Conformance Class WaterBody
- A.15. Conformance Class Construction
- A.16. Conformance Class Bridge
- A.17. Conformance Class Building
- A.18. Conformance Class Tunnel
- A.19. Conformance Class ADE
- Annex B: Revision History
- Annex C: Glossary
- Annex D: Bibliography
i. Abstract
This standard defines the open CityGML Conceptual Model Standard for the storage and exchange of virtual 3D city models. The CityGML Conceptual Model is defined by a Unified Modeling Language (UML) object model. This UML model builds on the ISO Technical Committee 211 (ISO/TC211) conceptual model standards for spatial and temporal data. Building on the ISO foundation assures that the man-made features described in the city models share the same spatiotemporal universe as the surrounding countryside within which they reside.
A key goal for the development of the CityGML Conceptual Model is to provide a common definition of the basic entities, attributes, and relations of a 3D city model. This is especially important with respect to the cost-effective sustainable maintenance of 3D city models, allowing the reuse of the same data in different application fields.
ii. Keywords
The following are keywords to be used by search engines and document catalogues.
ogcdoc, OGC document, CityGML, 3D city models
iii. Preface
Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. The Open Geospatial Consortium shall not be held responsible for identifying any or all such patent rights.
Recipients of this document are requested to submit, with their comments, notification of any relevant patent claims or other intellectual property rights of which they may be aware that might be infringed by any implementation of the standard set forth in this document, and to provide supporting documentation.
iv. Submitting organizations
This Document was submitted to the Open Geospatial Consortium (OGC) by the members of the CityGML Standards Working Group of the OGC. Amongst others, this comprises the following organizations:
-
To be provided
-
…
v. Submitters
All questions regarding this submission should be directed to the editors or the submitters:
| Name | Institution | |
|---|---|---|
Thomas H. Kolbe |
Chair of Geoinformatics, Technical University of Munich, Germany |
|
Tatjana Kutzner |
Chair of Geoinformatics, Technical University of Munich, Germany |
|
Carl Stephen Smyth |
OpenSitePlan, USA |
|
Claus Nagel |
virtualcitySYSTEMS, Germany |
|
Carsten Roensdorf |
Ordnance Survey, Great Britain |
|
Charles (Chuck) Heazel |
HeazelTech LLC |
|
Sylvester Hagler |
U.S. National Geospatial-Intelligence Agency |
vi. Participants in development
In addition to the Editors of the specification the following individuals contributed to the CityGML 3.0 development:
| Name | Institution |
|---|---|
Giorgio Agugiaro |
3D Geoinformation Group, Delft University of Technology, the Netherlands |
Christof Beil |
Chair of Geoinformatics, Technical University of Munich, Germany |
Filip Biljecki |
Department of Architecture, National University of Singapore, Singapore |
Kanishk Chaturvedi |
Chair of Geoinformatics, Technical University of Munich, Germany |
Volker Coors |
Stuttgart University of Applied Sciences, Germany |
Emmanuel Devys |
Institut national de l’information géographique et forestière (IGN), France |
Jürgen Ebbinghaus |
AED-SICAD, Germany |
Heinrich Geerling |
Architekturbüro Geerling, Germany |
Gilles Gesquière |
LIRIS, University of Lyon, France |
Gerhard Gröger |
CPA ReDev GmbH, Germany |
Karl-Heinz Häfele |
Institute for Automation and Applied Informatics, Karlsruhe Institute of Technology, Germany |
Nobuhiro Ishimaru |
Hitachi, Ltd., Japan |
Marc-Oliver Löwner |
Institute for Geodesy and Photogrammetry, Technische Universität Braunschweig, Germany |
Diana Moraru |
Ordnance Survey, Great Britain |
Friso Penninga |
Geonovum, the Netherlands |
Helga Tauscher |
Faculty of Spatial Information, HTW Dresden - University of Applied Sciences, Germany |
Linda van den Brink |
Geonovum, the Netherlands |
Heidi Vanparys |
Danish Agency for Data Supply and Efficiency, Denmark |
Sisi Zlatanova |
Faculty of Built Environment, University of New South Wales, Australia |
The table only lists persons that were involved in the development of CityGML 3.0. CityGML 3.0 is based on extensive previous work that was done for CityGML 2.0. For persons involved in the previous work, please refer to the CityGML 2.0 specification.
vii. Acknowledgements
The editors wish to thank the Special Interest Group 3D (SIG 3D) of the initiative Geodata Infrastructure Germany (GDI-DE) which originally started the development of CityGML, the CityGML Standards Working Group and the 3D Information Management (3DIM) Working Group of the OGC as well as all contributors of change requests and comments.
This is the official CityGML logo. For current news on CityGML and information about ongoing projects and fields of research in the area of CityGML see http://www.citygml.org and http://www.citygmlwiki.org.
1. Introduction
An increasing number of cities and companies are building virtual 3D city models for different application areas like urban planning, mobile telecommunication, disaster management, 3D cadastral, tourism, vehicle and pedestrian navigation, facility management and environmental simulations. Furthermore, in the implementation of the European Environmental Noise Directive (END, 2002/49/EC) 3D geoinformation and 3D city models play an important role.
In recent years, most virtual 3D city models were defined as purely graphical or geometrical models, neglecting the semantic and topological aspects. Thus, these models could almost only be used for visualization purposes but not for thematic queries, analysis tasks, or spatial data mining. Since the limited reusability of models inhibits the broader use of 3D city models and may not justify the costs associated with maintaining city models, a more general modelling approach had to be taken in order to satisfy the information needs of the various application fields.
The CityGML Conceptual Model Standard defines a common semantic information model for the representation of 3D urban objects that can be shared over different applications. The latter capability is especially important with respect to the cost-effective sustainable maintenance of 3D city models, allowing governments and companies to reap the benefits of their investment in 3D city models by being able to put the same models into play in different application fields. The targeted application areas explicitly include city planning, architectural design, tourist and leisure activities, environmental simulation, mobile telecommunication, disaster management, homeland security, real estate management, vehicle and pedestrian navigation, and training simulators.
The CityGML Conceptual Model defines the classes and relations for the most relevant topographic objects in cities and regional models with respect to their geometrical, topological, semantical, and appearance properties. “City” is broadly defined to comprise not just built structures, but also elevation, vegetation, water bodies, city furniture, and more. Included are generalization hierarchies between thematic classes, aggregations, relations between objects, and spatial properties. CityGML is applicable for large areas and small regions, and can represent the terrain and 3D objects in different levels of detail simultaneously. Since both simple, single scale models without topology and few semantics as well as very complex multi-scale models with full topology and fine-grained semantical differentiations can be represented, CityGML enables lossless information exchange between different geographic information systems and users.
2. Scope
This document is an OGC Conceptual Model (CM) Standard for specifying the representation of virtual 3D city and landscape models. The CityGML 3.0 Conceptual Model is a Platform Independent Model (PIM). A PIM is independent of any specific technological platform that may be used to implement it. expected to be the basis for a number of future Encoding Standards in which subsets of the Conceptual Model can be implemented. These Encoding Standards will enable both storage and exchange of data. At a minimum, support for a Geography Markup Language (GML) encoding is expected. Additional encodings in formats such as JSON and database schemas will be highly desirable.
In contrast to CityGML 2.0, the 3.0 Conceptual Model is NOT implemented as an application schema of GML. However, a preliminary encoding in GML version 3.2 is available as an informative resource separately from this standard to allow implementation and testing of the CityGML Conceptual Model.
The target of the conformance classes specified in this document are
-
CityGML Implementation Specifications that provide encodings for the UML conceptual model specified in this document, and
-
Additional UML models that can be created by users to extend this conceptual model as Application Domain Extensions (ADEs).
CityGML models are comprised of georeferenced 3D vector data along with the semantics associated with the data. In contrast to other 3D vector formats, CityGML is based on a rich, general purpose information model in addition to geometry and appearance information that allows for the integration of a variety of source data to come together in a City Model. To enable the use of CityGML in specific domain areas, CityGML has historically provided an extension mechanism to enrich the data with identifiable features and properties, preserving semantic interoperability. Recognizing that an implementable expansion mechanism might have dependencies based on the encoding language, the CityGML 3.0 Conceptual Model specifies high level requirements rather than a full extension model.
Targeted application areas explicitly include:
-
Urban and landscape planning;
-
Architectural design;
-
Tourist and leisure activities;
-
Environmental,
-
Energy and mobility simulations;
-
Mobile telecommunications;
-
Disaster management;
-
Homeland security;
-
Vehicle and pedestrian navigation;
-
Training simulators and mobile robotics.
The future CityGML 3.0 Implementation Specifications will be implementable source formats for 3D portraying or transformation into dedicated portrayal formats such as the OGC I3S or the OGC 3D Tiles Community Standards, OGC KML, COLLADA or glTF. The OGC 3D Portrayal Service (3DPS) may be used for content delivery.
Features of the CityGML 3.0 Conceptual Model:
-
Geospatial Information Model (ontology) for urban landscapes based on the ISO 19100 family.
-
Representation of 3D geometries, based on the ISO 19107 model, independent of data encodings, as well as of 3D point clouds.
-
Grouping into space hierarchies, including concepts like stories/floors within buildings.
-
Representation of object surface characteristics (e.g. textures, materials).
-
Representation of dynamic, i.e. time-dependent, properties of city models.
-
Taxonomies and aggregations including:
-
Digital Terrain Models as a combination of triangulated irregular networks (TINs), regular grids, break and skeleton lines, mass points.
-
Sites (currently buildings, other constructions, bridges, and tunnels).
-
Vegetation (areas, volumes, and solitary objects with vegetation classification).
-
Water bodies (volumes, surfaces).
-
Transportation facilities (graph structures, 3D space, and 3D surface data).
-
Land use (representation of areas of the earth’s surface dedicated to a specific land use).
-
City furniture.
-
Generic city objects and attributes.
-
User-definable (recursive) grouping.
-
-
Multiscale model with 4 well-defined consecutive Levels of Detail (LOD), applicable to both interior and exterior:
-
LOD0 – Highly generalized model.
-
LOD1 – Block model / extrusion objects.
-
LOD2 – Realistic, but still generalized model.
-
LOD3 – Highly detailed model.
-
-
Multiple representations in different LODs simultaneously and generalization relations between objects in different LODs.
-
Ability to combine different interior and exterior LODs, including representation of floor plans.
-
Optional topological connections between feature (sub)geometries.
-
Enables a variety of different encoding specifications, including GML and JSON.
-
Extension of the conceptual model through code lists, generic objects and Application Domain Extensions (ADEs).
-
With CityGML 3.0, ADEs become platform-independent models on a conceptual level that can be mapped to multiple and different target encodings. ADEs are implemented as UML models that extend the conceptual model in this standard. This includes a mechanism that favors the insertion of additional feature properties into any defined feature class through 'hooks' over subtyping of features. This means that the existing feature classes can be used and additional properties from one or more ADEs can easily be supported in different encodings.
-
Ability to specify an ADE that can be further extended.
3. Conformance
This standard defines a Conceptual Model which is independent of any encoding or formatting techniques. The Standardization Targets for this standard are:
-
Conceptual Models (extended versions of this conceptual model)
-
Implementation Specifications (encodings of this conceptual model)
3.1. Conceptual Models
A Conceptual Model standardization target is a version of the CityGML 3.0 Conceptual Model (CM) tailored for a specific user community. This tailoring can include:
-
Omission of one or more of the optional UML packages
-
Reduction of the multiplicity for an attribute or association
-
Restriction on the valid values for an attribute
-
Additional concepts documented through ADEs.
Of these options, actions #1, #2, and #3 can be performed when creating an implementation specification. Only action #4 requires an extension of the CityGML Conceptual Model. These extensions should be accomplished using the ADE mechanism described in Section 10 Application Domain Extensions (ADE).
Extensions of the CityGML Conceptual Model SHALL conform with the ADE Conformance Class.
3.2. Implementation Specifications
Implementation Specifications define how a Conceptual Model should be implemented using a specific technology. Conformant Implementation Specifications provide evidence that they are an accurate representation of the Conceptual Model. This evidence should include implementations of the abstract tests specified in Annex A (normative) of this document.
Since this standard is agnostic to the implementing technologies, the specific techniques to be used for conformance testing cannot be specified. Implementation Specifications need to provide evidence of conformance which is appropriate for the implementing technologies. This evidence should be provided as an annex to the Implementation Specification document.
3.3. Conformance Classes
This standard identifies seventeen (17) conformance classes. One conformance class is defined for each package in the UML model. Each conformance class is defined by one requirements class. The tests in Annex A are organized by Requirements Class. So an implementation of the Core conformance class must pass all tests specified in Annex A for the Core requirements class.
Of these seventeen conformance classes, only the Core conformance class is mandatory. All other conformance classes are optional. In the case where a conformance class has a dependency on another conformance class, that conformance class should also be implemented.
The CityGML Conceptual Model is defined by the CityGML UML model. This standard is a representation of that UML model in document form. In the case of a discrepancy between the UML model and this document, the UML model is authoritative.
4. References
The following normative documents contain provisions that, through reference in this text, constitute provisions of OGC 20-010. For dated references, subsequent amendments to, or revisions of, any of these publications do not apply. However, parties to agreements based on this part of OGC 20-010 are encouraged to investigate the possibility of applying the most recent editions of the normative documents indicated below. For undated references, the latest edition of the normative document referred to applies.
-
IETF: RFC 2045 & 2046, Multipurpose Internet Mail Extensions (MIME). (November 1996),
-
IETF: RFC 3986, Uniform Resource Identifier (URI): Generic Syntax. (January 2005)
-
INSPIRE: D2.8.III.2 Data Specification on Buildings – Technical Guidelines. European Commission Joint Research Centre.
-
ISO: ISO 19101-1:2014, Geographic information - Reference model - Part 1: Fundamentals
-
ISO: ISO 19103:2015, Geographic Information – Conceptual Schema Language
-
ISO: ISO 19105:2000, Geographic information – Conformance and testing
-
ISO: ISO 19107:2003, Geographic Information – Spatial Schema
-
ISO: ISO 19108:2002/Cor 1:2006, Geographic information – Temporal schema — Technical Corrigendum 1
-
ISO: ISO 19109:2015, Geographic Information – Rules for Application Schemas
-
ISO: ISO 19111:2019, Geographic information – Referencing by coordinates
-
ISO: ISO 19123:2005, Geographic information — Schema for coverage geometry and functions
-
ISO: ISO 19156:2011, Geographic information – Observations and measurements
-
ISO: ISO/IEC 19505-2:2012, Information technology — Object Management Group Unified Modeling Language (OMG UML) — Part 2: Superstructure
-
ISO/IEC 19507:2012, Information technology — Object Management Group Object Constraint Language (OCL)
-
ISO: ISO/IEC 19775-1:2013 Information technology — Computer graphics, image processing and environmental data representation — Extensible 3D (X3D) — Part 1: Architecture and base components
-
Khronos Group Inc.: COLLADA – Digital Asset Schema Release 1.5.0
-
OASIS: Customer Information Quality Specifications - extensible Address Language (xAL), Version v3.0
-
OGC: The OpenGIS® Abstract Specification Topic 5: Features, OGC document 08-126
-
OGC: The OpenGIS™ Abstract Specification Topic 8: Relationships Between Features, OGC document 99-108r2
-
OGC: The OpenGIS™ Abstract Specification Topic 10: Feature Collections, OGC document 99-110
5. Terms and Definitions
This document uses the terms defined in Sub-clause 5.3 of [OGC 06-121r8], which is based on the ISO/IEC Directives, Part 2, Rules for the structure and drafting of International Standards. In particular, the word “shall” (not “must”) is the verb form used to indicate a requirement to be strictly followed to conform to this Standard.
For the purposes of this document, the following additional terms and definitions apply.
2D data
geometry of features is represented in a two-dimensional space
NOTE In other words, the geometry of 2D data is given using (X,Y) coordinates.
[INSPIRE D2.8.III.2, definition 1]
2.5D data
geometry of features is represented in a three-dimensional space with the constraint that, for each (X,Y) position, there is only one Z
[INSPIRE D2.8.III.2, definition 2]
3D data
Geometry of features is represented in a three-dimensional space.
NOTE In other words, the geometry of 2D data is given using (X,Y,Z) coordinates without any constraints.
[INSPIRE D2.8.III.2, definition 3]
application schema
A set of conceptual schema for data required by one or more applications. An application schema contains selected parts of the base schemas presented in the ORM Information Viewpoint. Designers of application schemas may extend or restrict the types defined in the base schemas to define appropriate types for an application domain. Application schemas are information models for a specific information community.
OGC Definitions Register at http://www.opengis.net/def/glossary/term/ApplicationSchema
codelist
A value domain including a code for each permissible value.
conceptual model
model that defines concepts of a universe of discourse
[ISO 19101-1:2014, 4.1.5]
conceptual schema
-
formal description of a conceptual model
[ISO 19101-1:2014, 4.1.6] -
base schema. Formal description of the model of any geospatial information. <<application-schema-definition,Application schemas> are built from conceptual schemas.
OGC Definitions Register at http://www.opengis.net/def/glossary/term/ConceptualSchema
Implementation Specification
Specified on the OGC Document Types Register at http://www.opengis.net/def/doc-type/is
levels of detail
quantity of information that portrays the real world
NOTE The concept comprises data capturing rules of spatial object types, the accuracy and the types of geometries, and other aspects of a data specification. In particular, it is related to the notions of scale and resolution.
[INSPIRE Glossary]
life-cycle information
set of properties of a spatial object that describe the temporal characteristics of a version of a spatial object or the changes between versions
[INSPIRE Glossary]
6. Conventions
6.1. Identifiers
The normative provisions in this document are denoted by the URI
All requirements and conformance tests that appear in this document are denoted by partial URIs relative to this base.
6.2. UML Notation
The CityGML standard is presented in this document in diagrams using the Unified Modeling Language (UML) static structure diagram (see Booch et al. 1997). The UML notations used in this standard are described in the diagram in Figure 1.
All associations between model elements in the CityGML Conceptual Model are uni-directional. Thus, associations in the model are navigable in only one direction. The direction of navigation is depicted by an arrowhead. In general, the context an element takes within the association is indicated by its role. The role is displayed near the target of the association. If the graphical representation is ambiguous though, the position of the role has to be drawn to the element the association points to.
The following stereotypes are used in this model:
-
«ApplicationSchema» denotes a conceptual schema for data required by one or more applications. In the CityGML conceptual model, every module is defined as a separate application schema to allow for modularization.
-
«FeatureType» represents features that are similar and exhibit common characteristics. Features are abstractions of real-world phenomena and have an identity.
-
«TopLevelFeatureType» denotes features that represent the main components of the conceptual model. Top-level features may be further semantically and spatially decomposed and substructured into parts.
-
«Type» denotes classes that are not directly instantiable, but are used as an abstract collection of operation, attribute and relation signatures. The stereotype is used in the CityGML Conceptual Model only for classes that are imported from the ISO standards 19107, 19109, 19111, and 19123.
-
«ObjectType» represents objects that have an identity, but are not features.
-
«DataType» defines a set of properties that lack identity. A data type is a classifier with no operations, whose primary purpose is to hold information.
-
«Enumeration» enumerates the valid attribute values in a fixed list of named literal values. Enumerations are specified in the CityGML Conceptual Model.
-
«BasicType» defines a basic data type.
-
«CodeList» enumerates the valid attribute values. In contrast to Enumeration, the list of values is open and, thus, not given inline in the CityGML UML Model. The allowed values can be provided within an external code list.
-
«Union» is a list of attributes. The semantics are that only one of the attributes can be present at any time.
-
«Property» denotes attributes and association roles. This stereotype does not add further semantics to the conceptual model, but is required to be able to add tagged values to the attributes and association roles that are relevant for the encoding.
-
«Version» denotes that the value of an association role that ends at a feature type is a specific version of the feature, not the feature in general.
In order to enhance the readability of the CityGML UML diagrams, classes are depicted in different colors. The following coloring scheme is applied:
Classes painted in yellow belong to the Requirements Class which is subject of discussion in that clause of the standard in which the UML diagram is given. For example, in the context of Section 8.2, which introduces the CityGML Core module, the yellow color is used to denote classes that are defined in the CityGML Core Requirements Class. Likewise, the yellow classes shown in the UML diagram in Section 8.17 are associated with the Building Requirements Class that is subject of discussion in that chapter.
Classes painted in blue belong to a Requirements Class different to that associated with the yellow color. In order to explicitly denote to which Requirements Class these classes belong, their class names are preceded by the UML package name of that Requirements Class. For example, in the context of the Building Requirements Class, classes from the CityGML Core and the Construction Requirements Classes are painted in blue and their class names are preceded by Core and Construction, respectively.
Classes painted in green are defined in the ISO standards 19107, 19111, or 19123. Their class names are preceded by the UML package name, in which the classes are defined.
Classes painted in grey are defined in the ISO standard 19109. In the context of this standard, this only applies to the class AnyFeature. AnyFeature is an instance of the metaclass FeatureType and acts as super class of all classes in the CityGML UML model with the stereotype «FeatureType». A metaclass is a class whose instances are classes.
The color white is used for notes and Object Constraint Language (OCL) constraints that are provided in the UML diagrams.
The example UML diagram in Figure 2 demonstrates the UML notation and coloring scheme used throughout this standard. In this example, the yellow classes are associated with the CityGML Building module, the blue classes are from the CityGML Core and Construction modules, and the green class depicts a geometry element defined by ISO 19107.
6.3. Conceptual Modelling
ISO 19101 defines universe of discourse to be a view of the real or hypothetical world that includes everything of interest. That standard then defines conceptual model to be a model that defines concepts of a universe of discourse.
The scope of this CityGML Conceptual Model Standard establishes the limits of the universe of discourse for this Standard. The next task is to discover and standardize the concepts within this scope. CityGML will potentially support numerous diverse application software packages covering multiple disciplines and facility life cycle phases. Each conceivably can have its own universe of discourse and their own set of concepts.
The goal of this CityGML Conceptual Model Standard is to establish and document a common set of concepts that spans the applications supported. This does not attempt to redefine application concepts, but merely present a common set of concepts from and to which their concepts can be understood and mapped.
GML and JSON encodings are planned and other encodings are anticipated. Each encoding addresses a specific information community and set of application software packages. However, with the increasing desire to share information between communities and applications having a common conceptual model across all of these encodings is highly advantageous.
An added benefit of the development of a conceptual model results from the rigor involved in achieving consensus. After numerous iterations, the end result is consistent, cohesive, and complete. Updating a conceptual model is far easier than rewriting software code. Further, the iterations help to flesh out details as well as to unearth differences in individual conceptualizations.
Perhaps the greatest benefit of the standards activity is the ability to communicate the resultant model. This is in part due to using a standardized conceptual modelling language like UML and the agreed OGC and ISO/TC211 conventions for using UML. The eventual outcome of being able to provide formal documentation for what is meant by each concept is invaluable in understanding the subsequent encodings and applications.
This will be the first OGC conceptual model standard without accompanying encodings. Yet the model is presented in a manner consistent with the formalisms adopted for writing OGC standards. This standard follows the OGC Specification Model standard for modular specifications and is consistent with the OGC Naming Authority conventions and recommendations. The target of this Standard are the encoding standards which will follow and not the application software that will implement these encodings. Requirements for the encodings are explicit and grouped into Requirements Classes. Accompanying Conformance Classes are included to determine if an encoding conforms to the conceptual model.
UML has been used as the conceptual modelling language in this Standard. Class Diagrams have been created and inserted as Figures. The boxes in these diagrams (officially “Classifiers” in UML) typically represent classes, data types, enumerations, code lists, unions, etc. and this terminology is used throughout the Standard. However, since this is a Conceptual Model, these should all be interpreted to be “concepts”. For each Requirements Class, an introductory diagram is included which contains all of the concepts relevant to that Requirements Class.
Though redundant with the UML diagrams, all of the classes, class attributes, and associations are repeated in the Data Dictionary in Chapter 9. If these differ, the UML takes precedence.
7. Overview of CityGML
This standard defines an open CityGML Conceptual Model for the storage and exchange of virtual 3D city and landscape models. These models include the most relevant entities of the urban space like buildings, roads, railways, tunnels, bridges, city furniture, water bodies, vegetation, and the terrain. The conceptual schema specifies how and into which parts and pieces physical objects of the real world should be decomposed and classified. All objects can be represented with respect to their semantics, 3D geometry, 3D topology, appearances, and their changes over time. Different spatial representations can be provided for each object (outdoor and indoor) in four predefined Levels of Detail (LOD 0-3). The CityGML 3.0 Conceptual Model (Chapter 8) is formally specified using UML class diagrams, complemented by a data dictionary (Chapter 9) providing the definitions and explanations of the object classes and attributes. This Conceptual Model is the basis for multiple encoding standards, which map the concepts (or subsets thereof) onto exchange formats or database structures for data exchange and storage.
While the CityGML Conceptual Model can be used for 3D visualization purposes, its special merits lie in applications that go beyond visualization such as decision support, urban and landscape planning, urban facility management, Smart Cities, navigation (both indoor and outdoor), Building Information Modelling (especially for as-built documentation), integration of city and BIM models, assisted and autonomous driving, and simulations in general (cf. Kolbe 2009). A comprehensive overview on the many different applications of virtual 3D city models is given in [Biljecki et al. 2015]. Many of the applications already use and some even require using CityGML.
In CityGML all 3D city objects can easily be enriched with thematic data. For example, street objects can be enriched with information about traffic density, speed limit, number of lanes etc., or buildings can be enriched by information on the heating and electrical energy demand, numbers of households and inhabitants, the appraised building value etc. Even building parts like individual roof or wall surfaces can be enriched with information e.g. about solar irradiation and thermal insulation parameters. For many application domains specific extensions of the CityGML conceptual model have already been created (cf. Biljecki et al. 2018).
7.1. Modularisation
The CityGML conceptual model provides models for the most important types of objects within virtual 3D city and landscape models. These feature types have been identified to be either required or important in many different application areas. However, implementations are not required to support the overall CityGML conceptual model in order to be conformant to the standard, but may employ a subset of constructs according to their specific information needs. For this purpose, modularisation is applied to the CityGML conceptual model.
The CityGML conceptual model is thematically decomposed into a Core module and different kinds of extension modules as shown in Figure 3. The Core module (shown in green) comprises the basic concepts and components of the CityGML conceptual model and, thus, must be implemented by any conformant system. Each red coloured module covers a specific thematic field of virtual 3D city models. CityGML introduces the following eleven thematic extension modules: Building, Bridge, Tunnel, Construction, CityFurniture, CityObjectGroup, LandUse, Relief, Transportation, Vegetation, and WaterBody. All three modules Building, Bridge, and Tunnel model civil structures and share common concepts that are grouped within the Construction module. The five blue coloured extension modules add specific modelling aspects that can be used in conjunction with all thematic modules. The Appearance module contains the concepts to represent appearances (like textures and colours) of city objects. The PointCloud module provides concepts to represent the geometry of city objects by 3D point clouds. The Generics module defines the concepts for generic objects, attributes, and relationships. Versioning adds concepts for the representation of concurrent versions, real world object histories and feature histories. The Dynamizer module contains the concepts to represent city object properties by time series data and to link them with sensors, sensor data services or external files.
Each CityGML encoding can decide to only support a subset of CityGML modules. If a module is supported by an encoding, all concepts shall be mapped. However, the encoding specification can define so-called null mappings to restrict the use of specific elements of the conceptual model in an encoding. Null mappings can be expressed in an encoding specification for individual feature types, properties, and associations defined within a CityGML module. This means that the corresponding element will not be included in the respective encoding.
Note that also CityGML applications do not have to support all modules. Applications can also decide to only support a specific subset of CityGML modules. For example, when an application only has to work with building data, only the modules Core, Construction, and Building would have to be supported.
7.2. General Modelling Principles
7.2.1. Semantic Modelling of Real-World Objects
Real-world objects are represented by geographic features according to the definition in ISO 19109. Geographic features of the same type (e.g. buildings, roads) are modelled by corresponding feature types that are represented as classes in the Conceptual Model. The objects within a 3D city model are instances of the different feature types.
In order to distinguish and reference individual objects, each object has unique identifiers. In CityGML 3.0 each geographic feature has the mandatory featureID and an optional identifier property. The featureID is used to distinguish all objects and their possibly existing multiple versions of the same real-world object. The identifier is identical for all versions of the same real-world object and can be used to reference specific objects independent from their actual object version. The featureID must at least be unique within the same CityGML dataset, but it is generally recommended to use globally unique identifiers like UUID values or identifiers maintained by an organisation like a mapping agency. It is also recommended to provide globally unique and stable identifiers for the identifier attribute. This means these identifiers should remain stable over the lifetime of the real-world object.
CityGML feature types typically have a number of spatial and non-spatial properties (also called attributes) as well as relationships with other feature or object types. Note that a single CityGML object can have different spatial representations at the same time, for example, different geometry objects representing the feature’s geometry in different levels of detail or as different spatial abstractions.
Many attributes have simple, scalar values like a number or a character string. However, some attributes are complex, i.e. they do not just have a single property value. In CityGML the following types of complex attributes occur:
-
qualified attribute values – e.g. a measure consists of the value and a reference to the unit of measure, or e.g. for relative and absolute height levels the reference level has to be named, too
-
code list values for enumerative attributes; in addition to the value a link to the code list definition should be provided
-
attributes consisting of a tuple of different fields and values – e.g. addresses, space occupancy, and others
-
attribute value consisting of a list of numbers, for example, to represent coordinate lists or matrices
In order to support history, CityGML 3.0 introduces bitemporal timestamps for all objects. Besides the attributes creationDate and terminationDate from CityGML 2.0, which refer to the time period in which a specific version of an object is an integral part of the 3D city model, all objects now can additionally have the attributes validFrom and validTo, which represent the lifespan a specific version of an object has in the real-world. With these two time intervals a CityGML dataset could be queried both for how did the city look alike at a specific point in time as well as how did the city model look at that time.
The combination of the two types of feature identifiers explained above and bitemporal timestamps allows that not only the current version of a 3D city model, but also its entire history can be represented in CityGML and possibly exchanged even within a single file.
7.2.2. Class Hierarchy and Inheritance of Properties and Relations
In CityGML, the specific feature types like Building, Tunnel, or WaterBody are defined as subclasses of more general higher-level classes. Hence, feature types build a hierarchy along specialization / generalization relationships where more specialized feature types inherit the properties and relationships of all their superclasses along the entire generalization path to the topmost feature type AnyFeature.
7.2.3. Relationships between CityGML objects
In CityGML objects can be related to each other and different kinds of relations are distinguished. First of all, complex objects like buildings or transportation objects are typically consisting of parts. These parts are individual features of their own, and can even be further decomposed. Therefore, CityGML objects can form aggregation hierarchies. Some feature types are marked in the conceptual model with the stereotype «TopLevelFeatureType». These constitute the main objects of a city model and are typically the root of an aggregation hierarchy. Only top-level features are allowed as direct members of a CityModel object. The information which feature types belong to the top level is required for software packages that want to filter imports, exports, and visualizations according to the general type of a city object (e.g. only show buildings, solitary vegetation objects, and roads). Application Domain Extensions of CityGML should also make use of this concept, such that software tools can learn from inspecting their conceptual schema what are the main, i.e. the top-level, feature types of the extension.
Some relations in CityGML are qualified by additional parameters, typically to further specify the type of relationship. For example, a relationship can be qualified with a URI pointing to a definition of the respective relation type in an Ontology. Qualified relationships are used in CityGML, among others, for
-
general relationships between features – association relatedTo between city objects,
-
user-defined aggregations using CityObjectGroup – this relation allows also for recursive aggregations,
-
external references – linking of city objects with corresponding entities from external resources like objects in a cadastre or within a BIM dataset.
The CityGML conceptual model contains many relationships that are specifically defined between certain feature types. For example, there is the boundary relationship from 3D volumetric objects to its thematically differentiated 3D boundary surfaces. Another example is the generalizesTo relation between feature instances that represent objects on different generalisation levels.
In CityGML 3.0 there are new associations to express topologic, geometric, and semantic relations between all kinds of city objects. For example, it can be expressed that two rooms are adjacent or that one interior building installation (like a curtain rail) is overlapping with the spaces of two connected rooms. It can also be expressed that two wall surfaces are parallel and two others are orthogonal. Also distances between objects could be represented explicitly using geometric relations. In addition to spatial relations logical relations can be expressed.
7.2.4. Definition of the Semantics for all Classes, Properties, and Relations
The meanings of all elements defined in the CityGML conceptual model are normatively specified in the data dictionary in Chapter 9.
7.3. Representation of Spatial Properties
7.3.1. Geometry and Topology
Spatial properties of all CityGML feature types are represented using the geometry classes defined in ISO 19107. Spatial representations can have 0-, 1-, 2-, or 3-dimensional extents depending on the respective feature type and Levels of Detail (LOD; the LOD concept is discussed in Section 7.4.4 and Section 8.2.5). With only a few exceptions, all geometries must use 3D coordinate values. Besides primitive geometries like single points, curves, surfaces, and solids, CityGML makes use of different kinds of aggregations of geometries like spatial aggregates (MultiPoint, MultiCurve, MultiSurface, MultiSolid) and composites (CompositeCurve, CompositeSurface, CompositeSolid). Volumetric shapes are represented in ISO 19107 according to the so-called Boundary Representation (B-Rep, for explanation see Foley et al. 2002) only.
The CityGML conceptual model does not put any restriction on the usage of specific geometry types as defined in ISO 19107. For example, 3D surfaces could be represented in a dataset using 3D polygons, 3D meshes – i.e. as triangulated irregular networks, or by non-uniform rational B-spline surfaces (NURBS). However, an encoding may restrict the usage of geometry types. For example, curved lines like B-splines or clothoids, or curved surfaces like NURBS could be disallowed by explicitly defining null encodings for these concepts in the encoding specification (c.f. Section 7.1 above).
Note that the conceptual schema of ISO 19107 allows that composite geometries can be given by a recursive aggregation for every primitive type of the corresponding dimension. This aggregation schema allows the definition of nested aggregations (hierarchy of components). For example, a building geometry (CompositeSolid) can be composed of the house geometry (CompositeSolid) and the garage geometry (Solid), while the house’s geometry is further decomposed into the roof geometry (Solid) and the geometry of the house body (Solid). This is illustrated in Figure 4.
While CityGML does not employ the topology classes from ISO 19107, topological relations between geometries can be established by sharing geometries (typically parts of the boundary) between different geometric objects. One part of real-world space can be represented only once by a geometry object and is referenced by all features or more complex geometries which are defined or bounded by this geometry object. Thus redundancy can be avoided and explicit topological relations between parts are maintained.
Basically, there are three cases for sharing geometries: First, two different semantic objects may be spatially represented by the same geometry object. For example, if a foot path is both a transportation feature and a vegetation feature, the surface geometry defining the path is referenced both, by the transportation object and by the vegetation object. Second, a geometry object may be shared between a feature and another geometry. For example, a geometry defining a wall of a building may be referenced twice: by the solid geometry defining the geometry of the building, and by the wall feature. Third, two geometries may reference the same geometry, which is in the boundary of both. For example, a building and an adjacent garage may be represented by two solids. The surface describing the area where both solids touch may be represented only once and it is referenced by both solids. As it can be seen from Figure 4, this requires partitioning of the respective surfaces. In general, B-Rep only considers visible surfaces. However, to make topological adjacency explicit and to allow the possibility of deletion of one part of a composed object without leaving holes in the remaining aggregate, touching elements are included. Whereas touching is allowed, permeation of objects is not in order to avoid the multiple representation of the same space.
Another example for sharing geometry objects that are members of the boundaries in different higher-dimensional geometry objects is the sharing of point geometries or curve geometries, which make up the outer and inner boundaries of a polygon. This would allow that each point is only represented once, and different polygons could reference this point geometry. The same applies to the representation of curves for transportation objects like roads, whose end points could be shared e.g. between different road segments to topologically connect them.
Note that the use of topology in CityGML datasets by sharing geometries is optional. Furthermore, an encoding of the CityGML conceptual model might restrict the usage of shared geometries. For example, it might only be allowed to share identical (support) points from different 3D polygons or only entire polygons can be shared between touching solids (like shown in Figure 4).
7.3.2. Prototypic Objects / Scene Graph Concepts
In CityGML, objects of equal shape like trees and other vegetation objects, traffic lights and traffic signs can be represented as prototypes which are instantiated multiple times at different locations (see Figure 5). The geometry of prototypes is defined in local coordinate systems. Every instance is represented by a reference to the prototype, a base point in the world coordinate reference system and a transformation matrix that facilitates scaling, rotation, and translation of the prototype. The principle is adopted from the concept of scene graphs used in computer graphics standards like X3D and COLLADA. Since the ISO 19107 geometry model does not provide support for scene graph concepts, the CityGML class ImplicitGeometry has been introduced (for further description see Section 8.2.5). The prototype geometry can be represented using ISO 19107 geometry objects or by referencing an external file containing the geometry in another data format like X3D or COLLADA.
7.3.3. Point Cloud Representation
In addition to the spatial representations defined in the Core module, the geometry of physical spaces and of thematic surfaces can now also be provided by 3D point clouds using MultiPoint geometry. This allows, for example, to spatially represent the building hull, a room within a building or a single wall surface just by a point cloud. All thematic feature types including transportation objects, vegetation, city furniture, etc. can be spatially represented by point clouds, too. In this way, the ClearanceSpace of a road or railway could, for instance, be modelled directly from the result of a mobile laser scanning campaign. Point clouds can either be included in a CityGML dataset or just reference an external file of some common types such as LAS or LAZ.
7.3.4. Coordinate Reference Systems
CityGML is about 3D city and landscape models. This means that nearly all geometries use 3D coordinates, where each single point and also the points defining the boundaries of surfaces and solids have three coordinate values (x,y,z) each. Coordinates always have to be given with respect to a coordinate reference system (CRS) that relates them unambiguously with a specific position on Earth. In contrast to CAD or BIM, each 3D point is absolutely georeferenced, which makes CityGML especially suitable to represent geographically large extended structures like airports, railways, bridges, dams, where the Earth curvature has a significant effect on the object’s geometry (for further explanations see Kaden & Clemen 2017).
In most CRS, the (x,y) coordinates refer to the horizontal position of a point on the Earth’s surface. The z coordinate typically refers to the vertical height over (or under) the reference surface. Note that it depends on the chosen CRS whether x and y are given as angular values like latitude and longitude or as distance values in meters or feet. In general, all kinds of 3D CRS according to ISO 19111 can be used. This includes global as well as national reference systems using geocentric, geodetic, or projected coordinate systems.
7.4. CityGML Core Model: Space Concept, Levels of Detail, Special Spatial Types
7.4.1. Spaces and Space Boundaries
In CityGML 3.0, a clear semantic distinction of spatial features is introduced by mapping all city objects onto the semantic concepts of spaces and space boundaries. A Space is an entity of volumetric extent in the real world. Buildings, water bodies, trees, rooms, and traffic spaces are examples for such entities with volumetric extent. A Space Boundary is an entity with areal extent in the real world. Space Boundaries delimit and connect Spaces. Examples are the wall surfaces and roof surfaces that bound a building; the water surface as boundary between the water body and air; the road surface as boundary between the ground and the traffic space; or the digital terrain model representing the space boundary between the over- and underground space.
To obtain a more precise definition of spaces, they are further subdivided into physical spaces and logical spaces. Physical spaces are spaces that are fully or partially bounded by physical objects. Buildings and rooms, for instance, are physical spaces as they are bounded by walls and slabs. Traffic spaces of roads are physical spaces as they are bounded by road surfaces against the ground. Logical spaces, in contrast, are spaces that are not necessarily bounded by physical objects, but are defined according to thematic considerations. Depending on the application, logical spaces can also be bounded by non-physical, i.e. virtual boundaries, and they can represent aggregations of physical spaces. A building unit, for instance, is a logical space as it aggregates specific rooms to flats, the rooms being the physical spaces that are bounded by wall surfaces, whereas the aggregation as a whole is being delimited by a virtual boundary. Other examples are city districts which are bounded by virtual vertically extruded administrative boundaries; public spaces vs. Security zones in airports; or city zones with specific regulations stemming from urban planning. The definition of physical and logical spaces and of corresponding physical and virtual boundaries is in line with the discussion in [Smith & Varzi 2000] on the difference between bona fide and fiat boundaries to bound objects. Bona fide boundaries are physical boundaries; they correspond to the physical boundaries of physical spaces in CityGML 3.0. In contrast, fiat boundaries are man-made boundaries; they are equivalent to the virtual boundaries of logical spaces.
Physical spaces, in turn, are further classified into occupied spaces and unoccupied spaces. Occupied spaces represent physical volumetric objects that occupy space in the urban environment. Examples for occupied spaces are buildings, bridges, trees, city furniture, and water bodies. Occupying space means that some space is blocked by these volumetric objects; for instance, the space blocked by the building in Figure 6 cannot be used any more for driving through this space or placing a tree on that space. In contrast, unoccupied spaces represent physical volumetric entities that do not occupy space in the urban environment, i.e. no space is blocked by these volumetric objects. Examples for unoccupied spaces are building rooms and traffic spaces. There is a risk of misunderstanding the term OccupiedSpace. However, we decided to use the term anyway, as it is established in the field of robotics for over three decades [Elfes 1989]. The navigation of mobile robots makes use of a so-called occupancy map that marks areas that are occupied by matter and, thus, are not navigable for robots.
The new space concept offers several advantages:
-
In CityGML 3.0, all geometric representations are defined in the Core module only. This makes (a) models of the thematic modules simpler as they no longer need to be associated directly with the geometry classes, and (b) implementation easier as all spatial concepts have only to be implemented once in the Core module and all thematic modules like Building, Relief, WaterBody, etc. are inheriting them.
-
The space concept supports the expression of explicit topological, geometrical, and thematic relations between spaces and spaces, spaces and space boundaries, and space boundaries and space boundaries. Thus, implementing the checking of geometric-topological consistency will become easier, because most checks can be expressed and performed on the CityGML Core module and then automatically apply to all thematic modules
-
For the analysis of navigable spaces (e.g. to generate IndoorGML data from CityGML) algorithms can be defined on the level of the Core module. These algorithms will then work with all CityGML feature classes and also ADEs as they are derived from the Core. The same is true for other applications of 3D city models listed in [Biljecki et al. 2015] such as visibility analyses including shadow casting or solar irradiation analyses.
-
Practitioners and developers do not see much of the space concept, because the space and space boundary classes are just abstract classes. Only elements representing objects from concrete subclasses such as Building, BuildingRoom, or TrafficSpace will appear in CityGML data sets.
7.4.2. Modelling City Objects by the Composition of Spaces
Semantic objects in CityGML are often composed of parts, i.e. they form multi-level aggregation hierarchies. This also holds for semantic objects representing occupied and unoccupied spaces. In general, two types of compositions can be distinguished:
-
Spatial partitioning: Semantic objects of either the space type OccupiedSpace or UnoccupiedSpace are subdivided into different parts that are of the same space type as the parent object. Examples are Buildings that can be subdivided into BuildingParts, or Buildings that are partitioned into ConstructiveElements. Buildings as well as BuildingParts and constructiveElements represent OccupiedSpaces. Similarly, Roads can be subdivided into TrafficSpaces and AuxiliaryTrafficSpaces, all objects being UnoccupiedSpaces.
-
Nesting of alternating space types: Semantic objects of one space type contain objects that are of the opposite space type as the parent object. Examples are Buildings (OccupiedSpace) that contain BuildingRooms (UnoccupiedSpace), BuildingRooms (UnoccupiedSpace) that contain Furniture (OccupiedSpace), and Roads (UnoccupiedSpace) that contain CityFurniture (OccupiedSpace). The categorization of a semantic object into occupied or unoccupied takes place at the level of the object in relation to the parent object. A building is part of a city model; thus, in the first place it occupies urban space within a city. As long as the interior of the building is not modelled in detail, the space covered by the building needs to be considered as occupied and only viewable from the outside. To make the building accessible inside, voids need to be added to the building in the form of building rooms. The rooms add free space to the building interior, i.e. the OccupiedSpace contains now some UnoccupiedSpace. The free space inside the building can, in turn, contain objects that occupy space again, such as furniture or installations. In contrast, roads also occupy urban space in the city; however, this space is initially unoccupied as it is accessible by cars, pedestrian, or cyclists. Adding traffic signs or other city furniture objects to the free space results in specific sections of the road becoming occupied by these objects. Thus, one can also say that occupied spaces are mostly filled with matter; whereas, unoccupied spaces are mostly free of matter and, thus, realise free spaces.
7.4.3. Rules for Surface Orientations of OccupiedSpaces and UnoccupiedSpaces
The classification of feature types into OccupiedSpace and UnoccupiedSpace also defines the semantics of the geometries attached to the respective features. For OccupiedSpaces, the attached geometries describe volumes that are (mostly) physically occupied. For UnoccupiedSpaces, the attached geometries describe (or bound) volumes that are (mostly) physically unoccupied. This also has an impact on the required orientation of surface normals for attached thematic surfaces. For OccupiedSpaces, the normal vectors of thematic surfaces must point in the same direction as the surfaces of the outer shell of the volume. For UnoccupiedSpaces, the normal vectors of thematic surfaces must point in the opposite direction as the surfaces of the outer shell of the volume. This means that from the perspective of an observer of a city scene, the surface normals must always be directed towards the observer. In the case of OccupiedSpaces (e.g. Buildings, Furniture), the observer must be located outside the OccupiedSpace for the surface normals being directed towards the observer; whereas in the case of UnoccupiedSpaces (e.g. Rooms, Roads), the observer is typically inside the UnoccupiedSpace.
7.4.4. Levels of Detail (LOD)
CityGML differentiates four consecutive Levels of Detail (LOD 0-3), where objects become more detailed with increasing LOD regarding their geometry. CityGML datasets can - but do not have to - contain multiple geometries for each object in different LODs simultaneously. The LOD concept facilitates multi-scale modelling, i.e. having varying degrees of spatial abstractions that are appropriate for different applications or visualizations.
The classification of real-world objects into spaces and space boundaries is solely based on the semantics of these objects and not on their used geometry type, as CityGML 3.0 allows various geometrical representations for objects. A building, for instance, can be spatially represented by a 3D solid (e.g. in LOD1), but at the same time, the real-world geometry can also be abstracted by a single point, footprint or roofprint (LOD0), or by a 3D mesh (LOD3). The outer shell of the building may also be semantically decomposed into wall, roof, and ground surfaces. Figure 7 shows different representations of the same real-world building object in different geometric LODs (and appearances).
The biggest changes between CityGML 3.0 and earlier versions are that
-
LOD4 was dropped, because now all feature types can have outdoor and indoor elements in LODs 0-3 (for those city objects where it makes sense like buildings, tunnels, or bridges). This means that the outside shell e.g. of a building could be spatially represented in LOD2 and the indoor elements like rooms, doors, hallways, stairs etc. in LOD1. CityGML can now be used to represent building floor plans, which are LOD0 representations of building interiors (cf. Konde et al. 2018). It is even possible to model the outside shell of a building in LOD1, while representing the interior structure in LOD2 or 3. Figure 8 shows different indoor/outdoor representations of a building. Details on the changes to the CityGML LOD concept are provided in [Löwner et al. 2016].
-
Levels of Detail are no longer associated with the degree of semantic decomposition of city objects and refer to the spatial representations only. This means that, for example, buildings can have thematic surfaces (like WallSurface, GroundSurface) also in LODs 0 and 1 and windows and doors can be represented in all LODs 0-3. In CityGML 2.0 or earlier thematic surfaces were only allowed starting from LOD2, openings like doors and windows starting from LOD3, and interior rooms and furniture only in LOD4.
-
In CityGML 3.0 the geometry representations were moved from the thematic modules to the Core module and are now associated with the semantic concepts of Spaces and Space Boundaries. This led to a significant simplification of the models of the thematic modules. Since all feature types in the thematic modules are defined as subclasses of the space and space boundary classes, they automatically inherit the geometry classes and, thus, no longer require direct associations with them. This also led to a harmonized LOD representation over all CityGML feature types.
-
If new feature types are defined in Application Domain Extensions (ADEs) based on the abstract Space and Space Boundary classes from the Core module, they automatically inherit the spatial representations and the LOD concept.
Spaces and all its subclasses like Building, Room, and TrafficSpace can now be spatially represented by single points in LOD0, multi-surfaces in LOD0/2/3, solids in LOD1/2/3, and multi-curves in LOD2/3. Space Boundaries and all its subclasses such as WallSurface, LandUse, or Relief can now be represented by multi-surfaces in LOD0/2/3 and as multi-curves in LOD2/3. See Section 8.2.5 for further details on the different Levels of Detail.
7.4.5. Closure Surfaces
Objects, which are spatially not represented by a volumetric geometry, must be virtually closed in order to compute their volume (e.g. pedestrian underpasses or airplane hangars). They can be sealed using a specific type of space boundary called ClosureSurface. These are virtual surfaces, which are taken into account, when needed to compute volumes and are neglected, when they are irrelevant or not appropriate, for example in visualisations.
The concept of ClosureSurface can also be employed to model the entrances of subsurface objects. Those objects like tunnels or pedestrian underpasses have to be modelled as closed solids in order to compute their volume, for example in flood simulations. The entrances to subsurface objects also have to be sealed to avoid holes in the digital terrain model (see Figure 9). However, in close-range visualisations the entrance must be treated as open. Thus, closure surfaces are an adequate way to model those entrances.
7.4.6. Terrain Intersection Curves
An important issue in city modelling is the integration of 3D objects and the terrain. Problems arise if 3D objects float over or sink into the terrain. This is particularly the case when terrains and 3D objects in different LODs are combined, when the terrain and 3D models are updated independently from each other, or when they come from different data providers [Kolbe & Gröger 2003]. To overcome this problem, the TerrainIntersectionCurve (TIC) of a 3D object is introduced. These curves denote the exact position, where the terrain touches the 3D object (see Figure 10). TICs can be applied to all CityGML feature types that are derived from AbstractPhysicalSpace, for example, buildings, bridges, tunnels, but also city furniture, vegetation, and generic city objects.
If, for example, a building has a courtyard, the TIC consists of two closed rings: one ring representing the courtyard boundary, and one which describes the building’s outer boundary. This information can be used to integrate the building and a terrain by ‘pulling up’ or ‘pulling down’ the surrounding terrain to fit the TerrainIntersectionCurve. The digital terrain model (DTM) may be locally warped to fit the TIC. By this means, the TIC also ensures the correct positioning of textures or the matching of object textures with the DTM. Since the intersection with the terrain may differ depending on the LOD, a 3D object may have different TerrainIntersectionCurves for all LODs.
7.4.7. Coherent Semantical-Geometrical Modelling
An important design principle for CityGML is the coherent modelling of semantic objects and their spatial representations. At the semantic level, real-world entities are represented by features, such as buildings, walls, windows, or rooms. The description also includes attributes, relations and aggregation hierarchies (part-whole-relations) between features. Thus the part-of-relationship between features can be derived at the semantic level only, without considering geometry. However, at the spatial level, geometry objects are assigned to features representing their spatial location, shape, and extent. So the model consists of two hierarchies: the semantic and the geometrical in which the corresponding objects are linked by relationships (cf. Stadler & Kolbe 2007). The advantage of this approach is that it can be navigated in both hierarchies and between both hierarchies arbitrarily, for answering thematic and/or geometrical queries or performing analyses.
If both hierarchies exist for a specific object, they must be coherent (i.e. it must be ensured that they match and fit together). For example, if a building is semantically decomposed into wall surfaces, roof surfaces etc., the polygons representing these thematic surfaces (in a specific LOD) must be part of the solid geometry representing the entire building (for the same LOD).
7.5. Appearances
Information about the appearance of surfaces, i.e. observable properties of the surface, is considered an integral part of virtual 3D city and landscape models in addition to semantics and geometry. Appearance relates to any surface-based theme, e.g. infrared radiation or noise pollution, not just visual properties like RGB texture images. Consequently, data provided by appearances can be used as input for both, presentation of and analysis in virtual 3D city models.
CityGML supports feature appearances for an arbitrary number of themes per city model. Each LOD of a feature can have an individual appearance. Appearances can represent – among others – textures and georeferenced textures. CityGML’s appearance model is packaged within the Appearance module (cf. Section 8.3).
7.6. Modelling Dynamic Data
In general, city objects can have properties related to their geometry, topology, semantics, and appearance. All of these properties may change over time. For example, a construction event leads to the change in geometry of a building (i.e. addition of a new building floor or demolition of an existing door). The geometry of an object can be further classified according to its shape, location, and extent, which can also change over time. A moving car object involves changing only the location of the car object; however, a flood incident involves variations in the location and shape of water. There might be other properties, which change with respect to thematic data of city objects, e.g. hourly variations in energy or gas consumption of a building or changing the building usage from residential to commercial. Some properties involve changes in appearances over a time period, such as building textures changing over years or traffic cameras recording videos of moving traffic over definite intervals. 3D city models also represent interrelationships between objects and relations may change over time as well. Hence, it is important to consider that the representation of time-varying data is required to be associated with these different properties. A detailed discussion on the requirements of city model applications regarding the support of dynamic data is given in [Chaturvedi & Kolbe 2019].
CityGML 3.0 introduces two concepts to manage dynamic, i.e. time-dependent, properties of city models. The Versioning module manages changes that are slower in nature, e.g. (1) the history or evolution of cities such as construction or demolition of buildings, and (2) managing multiple versions of the city models. The Dynamizer module manages higher-frequent or dynamic variations of object properties, e.g. variations of (1) thematic attributes such as changes of physical quantities (energy demands, temperature, solar irradiation levels), (2) spatial properties such as change of a feature’s geometry, with respect to shape and location (moving objects), and (3) real-time sensor observations. The Dynamizer module allows establishing explicit links from city objects to sensors and sensor data services.
7.6.1. Versioning and Histories
The bitemporal timestamps of all CityGML feature types as described in Section 7.2.1 allow representing the evolution of the real city and its model over time. The new Versioning module extends this by the possibility to represent multiple, concurrent versions of the city model. For that purpose, the module defines two new feature types: 1) Version, which can be used to explicitly define named states of the 3D city model and denote all the specific versions of objects belonging to such states. 2) VersionTransition, which allows to explicitly link different versions of the 3D city model by describing the reason of change and the modifications applied. Details on the versioning concept are given in [Chaturvedi et al. 2015].
This approach not only facilitates the explicit representation of different city model versions, but also allows distinguishing and referring to different versions of city objects in an interoperable exchange format. All object versions could be stored and exchanged within a single dataset. Software systems could use such a dataset to visualize and work with the different versions simultaneously. The conceptual model also takes into account the management of multiple histories or multiple interpretations of the past of a city, which is required when looking at historical city developments and for archaeological applications. In addition, the Versioning module supports collaborative work, because it provides all functionalities to represent a tree of workspaces as version control systems like git or SVN. The Versioning module handles versions and version transitions as feature types, which allows the version management to be completely handled using the standard OGC Web Feature Service [Vrenatos 2010]. No extension of this standard is required to manage the versioning of city models.
7.6.2. Dynamizers: Using Time-Series Data for Object Attributes
The new Dynamizer module improves the usability of CityGML for different kinds of simulations as well as to facilitate the integration of devices from the Internet-of-Things (IoT) like sensors with 3D city models. Both, simulations and sensors provide dynamic variations of some measured or simulated properties like, for example, the electricity consumption of a building or the traffic density within a road segment. The variations of the value are typically represented using time-series data. The data sources of the time-series data could be either sensor observations (e.g. from a smart meter), pre-recorded load profiles (e.g. from an energy company), or the results of some simulation run.
As shown in Figure 11, Dynamizers serve three main purposes:
-
Dynamizer is a data structure to represent dynamic values in different and generic ways. Such dynamic values may be given by (1) tabulation of time/value pairs using its AtomicTimeseries class, (2) patterns of time/value pairs based on statistical rules using its CompositeTimeseries class, and (3) retrieving observations directly from external sensor/IoT services using its SensorConnection class. The values can be obtained from sensor services like the OGC Sensor Observation Service or OGC SensorThings API, simulation specific databases, and also external files such as CSV or Excel sheets.
-
Dynamizer delivers a method to enhance static city models by dynamic property values. It references a specific property (e.g. spatial, thematic or appearance properties) of a specific object within a 3D city model providing dynamic values overriding the static value of the referenced object attribute.
-
Dynamizer objects establish explicit links between sensor/observation data and the respective properties of city model objects that are measured by them. By making such explicit links with city object properties, the semantics of sensor data become implicitly defined by the city model.
Dynamizers are used to inject dynamic variations of city object properties into an otherwise static representation. The advantage in following such approach is that it allows only selected properties of city models to be made dynamic. If an application does not support dynamic data, it simply does not allow/include these special types of features.
Dynamizers have already been implemented as an Application Domain Extension (ADE) for CityGML 2.0 and were employed in the OGC Future City Pilot Phase 1. More details about Dynamizers are given in [Chaturvedi & Kolbe 2017].
7.7. Extending CityGML
CityGML has been designed as a universal topographic information model that defines object types and attributes which are useful for a broad range of applications. In practical applications, the objects within specific 3D city models will most likely contain attributes which are not explicitly modelled in CityGML. Moreover, there might be 3D objects which are not covered by the thematic classes of CityGML. CityGML provides three different concepts to support the exchange of such data:
The concept of generic objects and attributes allows for the extension of CityGML applications during runtime, i.e. any city object may be augmented by additional attributes and relations, whose names, data types, and values can be provided by a running application without requiring to extend the CityGML conceptual schema and the respective encodings. Similarly, features not represented by the predefined thematic classes of the CityGML conceptual model may be modelled and exchanged using generic objects. The generic extensions of CityGML are provided by the Generics module (cf. Section 8.7).
Application Domain Extensions (ADE) specify additions to the CityGML conceptual model. Such additions comprise the introduction of new properties to existing CityGML feature types like e.g. the energy demand of a building or the definition of additional feature types. The difference between ADEs and generic objects and attributes is, that an ADE has to be defined in an extra conceptual schema (provided in UML) with its own namespace. Encodings have to be extended accordingly. The advantage of this approach is that the extension is formally specified. Extended CityGML datasets can be validated against the CityGML and the respective ADE schema. ADEs can be defined (and even standardised) by information communities which are interested in specific application fields. More than one ADE can be used simultaneously in the same dataset. Examples for popular ADEs are the Utility Network ADE [Becker et al. 2011; Kutzner et al. 2018] and the Energy ADE [Nouvel et al. 2015; Agugiaro et al. 2018]. A comprehensive overview of CityGML ADEs is given in [Biljecki et al. 2018]. Further details on ADEs are given in Chapter 10.
CityGML can also be extended with regard to the allowed values specified in code lists. Many attributes of CityGML types use a code list as data type such as, for instance, the attributes class, usage, and function of city objects. A code list defines a value domain including a code for each permissible value. In contrast to fixed enumerations, modifications and extensions to the value domain become possible with code lists. The values for all code lists in CityGML have to be defined externally, for example, by adopting classifications from global, national, or industrial standards.
Additional information about the extension features of CityGML can be found in the CityGML 3.0 Users Guide.
8. CityGML UML Model
The CityGML UML model is the normative definition of the CityGML Conceptual Model. The tables and figures in this section were software generated from the UML model. As such, this section provides a normative representation of the CityGML Conceptual Model.
An alternate representation can be found in the Data Dictionary in Chapter 9.
8.1. Structural Overview of Requirements Classes
The Requirements Classes for this standard are structured as UML Packages as illustrated in Figure 12. Each Requirements Class is specified in detail in their respective subsections. These subsections include a UML diagram, data dictionary, and the applicable requirements.
8.2. Core
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-core |
|
Target type |
Implementation Specification |
Dependency |
|
Dependency |
|
Dependency |
|
Dependency |
|
Dependency |
|
Dependency |
|
The CityGML Core module defines the basic concepts and components of city models. This rather large body of work is divided into seven sections. These sections build on each other from the fundamental principles specified by the relevant ISO standards up to the full CityGML model. These sections are summarized in Table 3.
Describes the use of the ISO 19100 series of International Standards to provide a foundation to the CityGML model. |
|
Defines the basic building blocks of the CityGML model. |
|
Defines the concepts of space as used in the CityGML model. |
|
Defines the geometry and Levels Of Detail concepts. |
|
Presents the complete Core model. |
|
Defines the little things which make this model work. |
8.2.1. Requirements
The CityGML Core defines technology-agnostic concepts. These concepts are then realized in technology-specific Implementation Specifications. The following requirements govern the creation of any CityGML compliant Implementation Specification (IS).
Requirement 1 |
/req/core/classes |
For each UML class defined or referenced in the Core Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
While the CityGML Conceptual Model builds on ISO Standards, there are some restrictions on the use of those standards.
Requirement 2 |
/req/Core/isorestrictions |
ISO classes used in the CityGML Conceptual Model are subject to the following restrictions: |
|
A |
Classes derived from the GM_Solid class (ISO 19107) SHALL only include exterior boundaries. (The |
An implementing technology may not be able to support all of the concepts defined in the CityGML Conceptual Model. Alternately, some concepts from the Conceptual Model may be inappropriate for the application domain for which the Implementation Specification was developed. In those cases, elements of the Conceptual Model may be mapped to null elements in the Implementation Specification.
Permission 1 |
/per/Core/classes |
For each UML class defined or referenced in CityGML Conceptual Model: |
|
A |
An Implementation Specification MAY represent that class as a null class with no attributes, associations, or definition. |
B |
An Implementation Specification MAY represent an association of the UML class with a null association. |
C |
An Implementation Specification MAY represent an attribute of the UML class with a null attribute. |
D |
Whenever a null element is used to represent a concept from the Conceptual Model, the Implementation Specification SHOULD document that mapping and provide an explanation for why that concept was not implemented. |
Table 4 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Core module:
Space class |
Allowed space boundaries |
AbstractLogicalSpace |
|
AbstractOccupiedSpace |
|
AbstractPhysicalSpace |
|
AbstractSpace |
|
AbstractUnoccupiedSpace |
|
Surface boundaries are constrained by the following requirement:
Requirement 3 |
/req/core/boundaries |
Table 4 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Core module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 4 |
|
The use of extension capabilities by Core elements is constrained by the following requirement:
Requirement 4 |
/req/core/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.2.2. ISO Dependencies
CityGML builds on the ISO 19100 family of standards. The applicable standards are identified in the diagram in Figure 13. Data dictionaries are included for all of the ISO-defined classes explicitly referenced in the CityGML UML model. These data dictionaries are provided for the convenience of the user. The ISO standards are the normative source.
The ISO classes explicitly used in the CityGML UML model are introduced in Table 5. More details about these classes can be found in the Data Dictionary in Chapter 9.
Class Name |
Description |
A generalization of all feature types |
|
A coverage that returns the same feature attribute values for every direct position within any object in its domain. |
|
The coordinates for a position within some coordinate reference system. |
|
root class of the geometric object taxonomy. |
|
An aggregate class containing only instances of GM_OrientableCurve. |
|
An aggregate class containing only points. |
|
An aggregate class containing only instances of GM_OrientableSurface. |
|
The basic data type for a geometric object consisting of one and only one point. |
|
The basis for 3-dimensional geometry. The extent of a solid is defined by the boundary surfaces. |
|
The basis for 2-dimensional geometry. |
|
A GM_TriangulatedSurface which uses the Delaunay or similar algorithm. |
|
A GM_PolyhedralSurface that is composed only of triangles |
|
Coordinate reference system which is usually single but may be compound. |
|
A union class that consists of one of the data types listed as its attributes. |
8.2.3. City Models and City Objects
City models are virtual representations of real-world cities and landscapes. A city model aggregates different types of objects, which can be city objects, appearances, different versions of the city model, transitions between different versions of the city model, and feature objects. All objects defined in the CityGML CM are features with lifespan. This allows the optional specification of the real-world and database times for the existence of each feature, as is required by the Versioning module (cf. Section 8.13). Features that define thematic concepts related to cities and landscapes, such as building, bridge, water body, or land use, are referred to as city objects. All city objects define properties that describe the objects in more detail. These static properties can be overridden with time-varying data through Dynamizers (cf. Section 8.6).
The City Model and City Object classes defined in the CityGML UML model are introduced in Table 6. More details about these classes can be found in the Data Dictionary in Chapter 9.
Class |
Description |
AbstractAppearance |
AbstractAppearance is the abstract superclass to represent any kind of appearance objects. |
AbstractCityObject |
AbstractCityObject is the abstract superclass of all thematic classes within the CityGML Conceptual Model. |
AbstractDynamizer |
AbstractDynamizer is the abstract superclass to represent Dynamizer objects. |
AbstractFeature |
AbstractFeature is the abstract superclass of all feature types within the CityGML Conceptual Model. |
AbstractFeatureWithLifespan |
AbstractFeatureWithLifespan is the base class for all CityGML features. This class allows the optional specification of the real-world and database times for the existence of each feature. |
AbstractVersion |
AbstractVersion is the abstract superclass to represent Version objects. |
AbstractVersionTransition |
AbstractVersionTransition is the abstract superclass to represent VersionTransition objects. |
CityModel |
CityModel is the container for all objects belonging to a city model. |
8.2.4. Space Concept
All city objects are differentiated into spaces and space boundaries. Spaces are entities of volumetric extent in the real world. Buildings, water bodies, trees, rooms, and traffic spaces, for instance, have a volumetric extent. Spaces can be classified into physical spaces and logical spaces. Physical spaces, in turn, can be further classified into occupied spaces and unoccupied spaces.
Space boundaries, in contrast, are entities with areal extent in the real world. Space boundaries can be differentiated into different types of thematic surfaces, such as wall surfaces and roof surfaces.
A detailed introduction to the Space concept can be found in Section 7.4. In particular, the classification into OccupiedSpace and UnoccupiedSpace might not always be apparent at first sight. Carports, for instance, represent an OccupiedSpace, although they are not closed and most of the space is free of matter, see Figure 15. Since a carport is a roofed, immovable structure with the purpose of providing shelter to objects (i.e. cars), carports are frequently represented as buildings in cadastres. Thus, also in CityGML, a carport should be modelled as an instance of the class Building. Since Building is transitively a subclass of OccupiedSpace, a carport is an OccupiedSpace as well. However, only in LOD1, the entire volumetric region covered by the carport would be considered as physically occupied. In LOD1, the occupied space is defined by the entire carport solid (unless a room would be defined in LOD1 that would model the unoccupied part below the roof); whereas in LOD2 and LOD3, the solids represent more realistically the really physically occupied space of the carport. In addition, for all OccupiedSpaces, the normal vectors of the thematic surfaces like the RoofSurface need to point away from the solids, i.e. consistent with the solid geometry.
In contrast, a room is a physically unoccupied space. In CityGML, a room is represented by the class BuildingRoom that is a subclass of UnoccupiedSpace. In LOD1, the entire room solid would be considered as unoccupied space, which can contain furniture and installations, though, as is shown in Figure 16. In LOD2 and 3, the solid represents more realistically the really physically unoccupied space of the room (possibly somewhat generalized as indicated in the figure). For all UnoccupiedSpaces, the normal vectors of the bounding thematic surfaces like the InteriorWallSurface need to point inside the object, i.e. opposite to the solid geometry.
The UML diagram of the Space concept classes is depicted in Figure 17.
The Space Concept classes defined in the CityGML UML model are introduced in Table 7. More details about these classes can be found in the Data Dictionary in Chapter 9.
Class |
Description |
AbstractLogicalSpace |
AbstractLogicalSpace is the abstract superclass for all types of logical spaces. Logical space refers to spaces that are not bounded by physical surfaces but are defined according to thematic considerations. |
AbstractOccupiedSpace |
AbstractOccupiedSpace is the abstract superclass for all types of physically occupied spaces. Occupied space refers to spaces that are partially or entirely filled with matter. |
AbstractPhysicalSpace |
AbstractPhysicalSpace is the abstract superclass for all types of physical spaces. Physical space refers to spaces that are fully or partially bounded by physical objects. |
AbstractSpace |
AbstractSpace is the abstract superclass for all types of spaces. A space is an entity of volumetric extent in the real world. |
AbstractSpaceBoundary |
AbstractSpaceBoundary is the abstract superclass for all types of space boundaries. A space boundary is an entity with areal extent in the real world. Space boundaries are objects that bound a Space. They also realize the contact between adjacent spaces. |
AbstractThematicSurface |
AbstractThematicSurface is the abstract superclass for all types of thematic surfaces. |
AbstractUnoccupiedSpace |
AbstractUnoccupiedSpace is the abstract superclass for all types of physically unoccupied spaces. Unoccupied space refers to spaces that are entirely or mostly free of matter. |
ClosureSurface |
ClosureSurface is a special type of thematic surface used to close holes in volumetric objects. Closure surfaces are virtual (non-physical) surfaces. |
8.2.5. Geometry and LOD
Spaces and space boundaries can have various geometry representations depending on the Levels of Detail (LOD). Spaces can be spatially represented as single points in LOD0, multi-surfaces in LOD0/2/3, solids in LOD1/2/3, and multi-curves in LOD2/3. Space boundaries can be represented as multi-surfaces in LOD0/2/3 and as multi-curves in LOD2/3. All Levels of Detail allow for the representation of the interior of city objects.
The different Levels of Detail are defined in the following way:
-
LOD 0: Volumetric real-world objects (Spaces) can be spatially represented by a single point, by a set of curves, or by a set of surfaces. Areal real-world objects (Space Boundaries) can be spatially represented in LOD0 by a set of curves or a set of surfaces. LOD0 surface representations are typically the result of a projection of the shape of a volumetric object onto a plane parallel to the ground, hence, representing a footprint (e.g. a building footprint or a floor plan of the rooms inside a building). LOD0 curve representations are either the result of a projection of the shape of a vertical surface (e.g. a wall surface) onto a grounding plane or the skeleton of a volumetric shape of longitudinal extent such as a road or river segment.
-
LOD 1: Volumetric real-world objects (Spaces) are spatially represented by a vertical extrusion solid, i.e. a solid created from a horizontal footprint by vertical extrusion. Areal real-world objects (Space Boundaries) can be spatially represented in LOD1 by a set of horizontal or vertical surfaces.
-
LOD 2: Volumetric real-world objects (Spaces) can be spatially represented by a set of curves, a set of surfaces, or a single solid geometry. Areal real-world objects (Space Boundaries) can be spatially represented in LOD2 by a set of surfaces. The shape of the real-world object is generalized in LOD2 and smaller details (e.g. bulges, dents, sills, but also structures like e.g. balconies or dormers of buildings) are typically neglected. LOD2 curve representations are skeletons of volumetric shapes of longitudinal extent like an antenna or a chimney.
-
LOD 3: Volumetric real-world objects (Spaces) can be spatially represented by a set of curves, a set of surfaces, or a single solid geometry. Areal real-world objects (Space Boundaries) can be spatially represented in LOD3 by a set of surfaces. LOD3 is the highest level of detail and respective geometries include all available shape details.
In addition, the geometry can also be represented implicitly. The shape is stored only once as a prototypical geometry, which then is re-used or referenced, wherever the corresponding feature occurs in the 3D city model.
The thematic classes, such as building, tunnel, road, land use, water body, or city furniture are defined as subclasses of the space and space boundary classes within the thematic modules. Since all city objects in the thematic modules represent subclasses of the space and space boundary classes, they automatically inherit the geometries defined in the Core module.
The UML diagram of the Geometry and LoD concept classes is depicted in Figure 18.
The Geometry and LOD Concept classes defined in the CityGML UML model are introduced in Table 8. More details about these classes can be found in the Data Dictionary in Chapter 9.
Of particular note is the Implicit Geometry concept. Many of the objects encountered in a city landscape have the same geometry. How many types of street lamps can there be? An Implicit Geometry captures that geometry once, and re-uses that one geometry for all similar street lamp objects.
Class |
Description |
AbstractOccupiedSpace |
AbstractOccupiedSpace is the abstract superclass for all types of physically occupied spaces. Occupied space refers to spaces that are partially or entirely filled with matter. |
AbstractPhysicalSpace |
AbstractPhysicalSpace is the abstract superclass for all types of physical spaces. Physical space refers to spaces that are fully or partially bounded by physical objects. |
AbstractPointCloud |
AbstractPointCloud is the abstract superclass to represent PointCloud objects. |
AbstractSpace |
AbstractSpace is the abstract superclass for all types of spaces. A space is an entity of volumetric extent in the real world. |
AbstractThematicSurface |
AbstractThematicSurface is the abstract superclass for all types of thematic surfaces. |
ImplicitGeometry |
ImplicitGeometry is a geometry representation where the shape is stored only once as a prototypical geometry. For example a tree or other vegetation object, a traffic light or a traffic sign. This prototypic geometry object can be re-used or referenced many times, wherever the corresponding feature occurs in the 3D city model. |
8.2.6. CityGML Core Model
The City Model and City Object classes, the Space Concept classes, and the Geometry and LOD classes define the majority of the CityGML Core module. In addition to these concepts, the Core module also specifies that city objects can have relations to other city objects and that they can have address information. All other modules defined in the CityGML model refer to the Core module.
The UML diagram of the complete Core module is depicted in Figure 19.
Table 6, Table 7, and Table 8 introduce already most of the classes of the CityGML Core module. The additional classes required to complete this section of the standard are introduced in Table 9. More details about these classes can be found in the Data Dictionary in Chapter 9.
Class |
Description |
Address |
Address represents an address of a city object. |
CityObjectRelation |
CityObjectRelation represents a specific relation from the city object in which the relation is included to another city object. |
8.2.7. Data types, Enumerations, and Code lists
The ADE data types provided for in the Core module are illustrated in the figure Figure 20.
The Data Types, Basic Types, Enumerations, Unions, and Code Lists provided for the Core module are illustrated in Figure 21.
These supporting constructs are defined in the following tables.
Name |
Description |
AbstractGenericAttribute |
AbstractGenericAttribute is the abstract superclass for all types of generic attributes. |
ADEOfAbstractAppearance |
ADEOfAbstractAppearance acts as a hook to define properties within an ADE that are to be added to AbstractAppearance. |
ADEOfAbstractCityObject |
ADEOfAbstractCityObject acts as a hook to define properties within an ADE that are to be added to AbstractCityObject. |
ADEOfAbstractDynamizer |
ADEOfAbstractDynamizer acts as a hook to define properties within an ADE that are to be added to AbstractDynamizer. |
ADEOfAbstractFeature |
ADEOfAbstractFeature acts as a hook to define properties within an ADE that are to be added to AbstractFeature. |
ADEOfAbstractFeatureWithLifespan |
ADEOfAbstractFeatureWithLifespan acts as a hook to define properties within an ADE that are to be added to AbstractFeatureWithLifespan. |
ADEOfAbstractLogicalSpace |
ADEOfAbstractLogicalSpace acts as a hook to define properties within an ADE that are to be added to AbstractLogicalSpace. |
ADEOfAbstractOccupiedSpace |
ADEOfAbstractOccupiedSpace acts as a hook to define properties within an ADE that are to be added to AbstractOccupiedSpace. |
ADEOfAbstractPhysicalSpace |
ADEOfAbstractPhysicalSpace acts as a hook to define properties within an ADE that are to be added to AbstractPhysicalSpace. |
ADEOfAbstractPointCloud |
ADEOfAbstractPointCloud acts as a hook to define properties within an ADE that are to be added to AbstractPointCloud. |
ADEOfAbstractSpace |
ADEOfAbstractSpace acts as a hook to define properties within an ADE that are to be added to AbstractSpace. |
ADEOfAbstractSpaceBoundary |
ADEOfAbstractSpaceBoundary acts as a hook to define properties within an ADE that are to be added to AbstractSpaceBoundary. |
ADEOfAbstractThematicSurface |
ADEOfAbstractThematicSurface acts as a hook to define properties within an ADE that are to be added to AbstractThematicSurface. |
ADEOfAbstractUnoccupiedSpace |
ADEOfAbstractUnoccupiedSpace acts as a hook to define properties within an ADE that are to be added to AbstractUnoccupiedSpace. |
ADEOfAbstractVersion |
ADEOfAbstractVersion acts as a hook to define properties within an ADE that are to be added to AbstractVersion. |
ADEOfAbstractVersionTransition |
ADEOfAbstractVersionTransition acts as a hook to define properties within an ADE that are to be added to AbstractVersionTransition. |
ADEOfAddress |
ADEOfAddress acts as a hook to define properties within an ADE that are to be added to an Address. |
ADEOfCityModel |
ADEOfCityModel acts as a hook to define properties within an ADE that are to be added to a CityModel. |
ADEOfClosureSurface |
ADEOfClosureSurface acts as a hook to define properties within an ADE that are to be added to a ClosureSurface. |
ExternalReference |
ExternalReference is a reference to a corresponding object in another information system, for example in the German cadastre (ALKIS), the German topographic information system (ATKIS), or the OS UK MasterMap®. |
Occupancy |
Occupancy is an application-dependent indication of what is contained by a feature. |
QualifiedArea |
QualifiedArea is an application-dependent measure of the area of a space or of a thematic surface. |
QualifiedVolume |
QualifiedVolume is an application-dependent measure of the volume of a space. |
XALAddress |
XALAddress represents address details according to the OASIS xAL standard. |
Name |
Description |
Code |
Code is a basic type for a String-based term, keyword, or name that can additionally have a code space. |
DoubleBetween0and1 |
DoubleBetween0and1 is a basic type for values, which are greater or equal than 0 and less or equal than 1. The type is used for color encoding, for example. |
DoubleBetween0and1List |
DoubleBetween0and1List is a basic type that represents a list of double values greater or equal than 0 and less or equal than 1. The type is used for color encoding, for example. |
DoubleList |
DoubleList is an ordered sequence of double values. |
DoubleOrNilReasonList |
DoubleOrNilReasonList is a basic type that represents a list of double values and/or nil reasons. |
ID |
ID is a basic type that represents a unique identifier. |
IntegerBetween0and3 |
IntegerBetween0and3 is a basic type for integer values, which are greater or equal than 0 and less or equal than 3. The type is used for encoding the LOD number. |
MeasureOrNilReasonList |
MeasureOrNilReasonList is a basic type that represents a list of double values and/or nil reasons together with a unit of measurement. |
TransformationMatrix2x2 |
TransformationMatrix2x2 is a 2 by 2 matrix represented as a list of four double values in row major order. |
TransformationMatrix3x4 |
TransformationMatrix3x4 is a 3 by 4 matrix represented as a list of twelve double values in row major order. |
TransformationMatrix4x4 |
TransformationMatrix4x4 is a 4 by 4 matrix represented as a list of sixteen double values in row major order. |
Name |
Description |
CityModelMember |
CityModelMember is a union type that enumerates the different types of objects that can occur as members of a city model. |
DoubleOrNilReason |
DoubleOrNilReason is a union type that allows for choosing between a double value and a nil reason. |
NilReason |
NilReason is a union type that allows for choosing between two different types of nil reason. |
Name |
Description |
RelativeToTerrain |
RelativeToTerrain enumerates the spatial relations of a city object relative to terrain in a qualitative way. |
RelativeToWater |
RelativeToWater enumerates the spatial relations of a city object relative to the water surface in a qualitative way. |
SpaceType |
SpaceType is an enumeration that characterises a space according to its closure properties. |
Name |
Description |
IntervalValue |
IntervalValue is a code list used to specify a time period. |
MimeTypeValue |
MimeTypeValue is a code list used to specify the MIME type of a referenced resource. |
NilReasonEnumeration |
NilReasonEnumeration is a code list that enumerates the different nil reasons. |
OccupantTypeValue |
OccupantTypeValue is a code list used to classify occupants. |
OtherRelationTypeValue |
OtherRelationTypeValue is a code list used to classify other types of city object relations. |
QualifiedAreaTypeValue |
QualifiedAreaTypeValue is a code list used to specify area types. |
QualifiedVolumeTypeValue |
QualifiedVolumeTypeValue is a code list used to specify volume types. |
RelationTypeValue |
RelationTypeValue is a code list used to classify city object relations. |
TemporalRelationTypeValue |
TemporalRelationTypeValue is a code list used to classify temporal city object relations. |
TopologicalRelationTypeValue |
TopologicalRelationTypeValue is a code list used to classify topological city object relations. |
8.2.8. Additional Information
A detailed discussion of the CityGML Core can be found in the OGC CityGML 3.0 Users Guide.
8.3. Appearance
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-appearance |
|
Target type |
Implementation Specification |
Dependency |
|
The Appearance module provides the representation of surface data such as observable properties for surface geometry objects in the form of textures and material.
Appearances are not limited to visual data but represent arbitrary categories called themes such as infrared radiation, noise pollution, or earthquake-induced structural stress. A single surface geometry object may have surface data for multiple themes. Similarly, surface data can be shared by multiple surface geometry objects (e.g. road paving).
Surface data that is constant across a surface is modelled as material based on the material definitions from the X3D and COLLADA standards. Surface data that depends on the exact location within the surface is modelled as a texture. This can either be a parameterized texture (a texture that uses texture coordinates) or a transformation matrix for parameterization, or a georeferenced texture (a texture that uses a planimetric projection).
Each surface geometry object can have both, a material and a texture per theme and side. This allows for providing a constant approximation and a complex measurement of a surface’s property simultaneously.
The UML diagram of the Appearance module is illustrated in Figure 22. A detailed discussion of this Requirements Class can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Appearance module are illustrated in Figure 23.
8.3.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Appearance Module as an Implementation Specification.
Requirement 5 |
/req/appearance/classes |
For each UML class defined or referenced in the Appearance Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The use of extension capabilities by Appearance elements is constrained by the following requirement:
Requirement 6 |
/req/appearance/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.3.2. Class Definitions
Class |
Description |
AbstractSurfaceData |
AbstractSurfaceData is the abstract superclass for different kinds of textures and material. |
AbstractTexture |
AbstractTexture is the abstract superclass to represent the common attributes of the classes ParameterizedTexture and GeoreferencedTexture. |
Appearance |
An Appearance is a collection of surface data, i.e. observable properties for surface geometry objects in the form of textures and material. |
GeoreferencedTexture |
A GeoreferencedTexture is a texture that uses a planimetric projection. It contains an implicit parameterization that is either stored within the image file, an accompanying world file or specified using the orientation and referencePoint elements. |
ParameterizedTexture |
A ParameterizedTexture is a texture that uses texture coordinates or a transformation matrix for parameterization. |
X3DMaterial |
X3DMaterial defines properties for surface geometry objects based on the material definitions from the X3D and COLLADA standards. |
TextureAssociation |
TextureAssociation denotes the relation of a texture to a surface geometry object. |
Name |
Description |
AbstractTextureParameterization |
AbstractTextureParameterization is the abstract superclass for different kinds of texture parameterizations. |
ADEOfAbstractSurfaceData |
ADEOfAbstractSurfaceData acts as a hook to define properties within an ADE that are to be added to AbstractSurfaceData. |
ADEOfAbstractTexture |
ADEOfAbstractTexture acts as a hook to define properties within an ADE that are to be added to AbstractTexture. |
ADEOfAppearance |
ADEOfAppearance acts as a hook to define properties within an ADE that are to be added to an Appearance. |
ADEOfGeoreferencedTexture |
ADEOfGeoreferencedTexture acts as a hook to define properties within an ADE that are to be added to a GeoreferencedTexture. |
ADEOfParameterizedTexture |
ADEOfParameterizedTexture acts as a hook to define properties within an ADE that are to be added to a ParameterizedTexture. |
ADEOfX3DMaterial |
ADEOfX3DMaterial acts as a hook to define properties within an ADE that are to be added to an X3DMaterial. |
TexCoordGen |
TexCoordGen defines texture parameterization using a transformation matrix. |
TexCoordList |
TexCoordList defines texture parameterization using texture coordinates. |
Name |
Description |
Color |
Color is a list of three double values between 0 and 1 defining an RGB color value. |
ColorPlusOpacity |
Color is a list of four double values between 0 and 1 defining an RGBA color value. Opacity value of 0 means transparent. |
Name |
Description |
TextureType |
TextureType enumerates the different texture types. |
WrapMode |
WrapMode enumerates the different fill modes for textures. |
8.3.3. Additional Information
Additional information about the Appearance Module can be found in the OGC CityGML 3.0 Users Guide
8.4. City Furniture
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-cityfurniture |
|
Target type |
Implementation Specification |
Dependency |
|
The CityFurniture module provides the representation of objects or pieces of equipment that are installed in the outdoor environment for various purposes, such as decoration, explanation or control. City furniture objects are relatively small, immovable objects and usually are of stereotypical form. Examples include road signs, traffic signals, bicycle racks, street lamps, fountains, flower buckets, advertising columns, and benches.
City furniture is represented in the UML model by the top-level feature type CityFurniture, which is also the only class of the CityFurniture module.
The UML diagram of the CityFurniture module is depicted in Figure 24. A detailed discussion of this Requirements Class can be found in the CityGML 3.0 Users Guide.
The ADE data types and Code Lists provided for the CityFurniture module are illustrated in Figure 25.
Table 19 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the CityFurniture module:
Space class |
Allowed space boundaries |
CityFurniture |
|
8.4.1. Requirements
The following requirement defines the rules governing implementation of the CityGML City Furniture Module as an Implementation Specification.
Requirement 7 |
/req/cityfurniture/classes |
For each UML class defined or referenced in the CityFurniture Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 8 |
/req/cityfurniture/boundaries |
Table 19 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the CityFurniture module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 19 |
|
The use of extension capabilities by City Furniture elements is constrained by the following requirement:
Requirement 9 |
/req/cityfurniture/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.4.2. Class Definitions
Class |
Description |
CityFurniture |
CityFurniture is an object or piece of equipment installed in the outdoor environment for various purposes. Examples include street signs, traffic signals, street lamps, benches, fountains. |
Name |
Description |
ADEOfCityFurniture |
ADEOfCityFurniture acts as a hook to define properties within an ADE that are to be added to a CityFurniture. |
Name |
Description |
CityFurnitureClassValue |
CityFurnitureClassValue is a code list used to further classify a CityFurniture. |
CityFurnitureFunctionValue |
CityFurnitureFunctionValue is a code list that enumerates the different purposes of a CityFurniture. |
CityFurnitureUsageValue |
CityFurnitureUsageValue is a code list that enumerates the different uses of a CityFurniture. |
8.4.3. Additional Information
Additional information about the City Furniture Module can be found in the OGC CityGML 3.0 Users Guide
8.5. City Object Group
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-cityobjectgroup |
|
Target type |
Implementation Specification |
Dependency |
|
The CityObjectGroup module provides the application-specific aggregation of city objects according to some user-defined criteria. Examples for groups are the buildings in a specific region, the result of a query, or objects put together for visualization purposes. Each member of a group may be qualified by a role name, reflecting the role each city object plays in the context of the group. City object groups are represented in the UML model by the top-level feature type CityObjectGroup, which is the main class of the CityObjectGroup module.
City object groups can be linked to other city objects, the so-called parent objects, which allows for modelling a generic hierarchical grouping concept. In addition, as city object groups represent city objects themselves, a group may become a member of another group realizing recursive aggregation in this way.
The UML diagram of the CityObjectGroup module is depicted in Figure 26. A detailed discussion of this Requirements Class can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the CityObjectGroup module are illustrated in Figure 27.
The Code Lists provided for the CityObjectGroup module are illustrated in Figure 28.
Table 23 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the CityObjectGroup module:
Space class |
Allowed space boundaries |
CityObjectGroup |
|
8.5.1. Requirements
The following requirement defines the rules governing implementation of the CityGML City Object Group Module as an Implementation Specification.
Requirement 10 |
/req/cityobjectgroup/classes |
For each UML class defined or referenced in the CityObjectGroup Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 11 |
/req/cityobjectgroup/boundaries |
Table 23 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the CityObjectGroup module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 23 |
|
The use of extension capabilities by City Object Group elements is constrained by the following requirement:
Requirement 12 |
/req/cityobjectgroup/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.5.2. Class Definitions
Class |
Description |
CityObjectGroup |
A CityObjectGroup represents an application-specific aggregation of city objects according to some user-defined criteria. Examples for groups are the buildings in a specific region, the result of a query, or objects put together for visualization purposes. Each member of a group may be qualified by a role name, reflecting the role each city object plays in the context of the group. |
Role |
Role qualifies the function of a city object within the CityObjectGroup. |
Name |
Description |
ADEOfCityObjectGroup |
ADEOfCityObjectGroup acts as a hook to define properties within an ADE that are to be added to a CityObjectGroup. |
Name |
Description |
CityObjectGroupClassValue |
CityObjectGroupClassValue is a code list used to further classify a CityObjectGroup. |
CityObjectGroupFunctionValue |
CityObjectGroupFunctionValue is a code list that enumerates the different purposes of a CityObjectGroup. |
CityObjectGroupUsageValue |
CityObjectGroupUsageValue is a code list that enumerates the different uses of a CityObjectGroup. |
8.5.3. Additional Information
Additional information about the City Object Group Module can be found in the OGC CityGML 3.0 Users Guide.
8.6. Dynamizer
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-dynamizer |
|
Target type |
Implementation Specification |
Dependency |
|
The Dynamizer module provides the concepts that enable representation of time-varying data for city object properties as well as for integrating sensors with 3D city models. Dynamizers are objects that inject timeseries data for an individual attribute of the city object in which the timeseries data is included. In order to represent dynamic (time-dependent) variations of its value, the timeseries data overrides the static value of the referenced city object attribute.
The dynamic values may be given by retrieving observation results directly from external sensor/IoT services using a sensor connection (e.g. OGC SensorThings API, Sensor Observation Service, or other sensor data platforms including MQTT). Alternatively, the dynamic values may be provided as atomic timeseries that represent time-varying data of a specific data type for a single contiguous time interval. The data can be provided in:
-
external tabulated files, such as CSV or Excel sheets,
-
external files that format timeseries data according to the OGC TimeseriesML Standard or the OGC Observations & Measurements standards,
-
or inline as embedded time-value-pairs.
Furthermore, timeseries data can also be aggregated to form composite timeseries with non-overlapping time intervals.
By using the Dynamizer module, fast changes over a short or longer time period with respect to cities and city models can be represented. This includes:
-
variations of spatial properties such as change of a feature’s geometry, both in respect to shape and to location (e.g. moving objects),
-
variations of thematic attributes,
-
changes of physical quantities like energy demands, temperatures, solar irradiation, traffic density, pollution concentration, or overpressure on building walls,
-
and variations with respect to sensor or real-time data resulting from simulations or measurements.
The UML diagram of the Dynamizer module is depicted in Figure 29. A detailed discussion of this Requirements Class can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Dynamizer module are illustrated in Figure 30.
The Code Lists provided for the Dynamizer module are illustrated in Figure 31.
8.6.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Dynamizer Module as an Implementation Specification.
Requirement 13 |
/req/dynamizer/classes |
For each UML class defined or referenced in the Dynamizer Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The use of extension capabilities by Dynamizer elements is constrained by the following requirement:
Requirement 14 |
/req/dynamizer/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.6.2. Class Definitions
Class |
Description |
AbstractAtomicTimeseries |
AbstractAtomicTimeseries represents the attributes and relationships that are common to all kinds of atomic timeseries (GenericTimeseries, TabulatedFileTimeseries, StandardFileTimeseries). An atomic timeseries represents time-varying data of a specific data type for a single contiguous time interval. |
AbstractTimeseries |
AbstractTimeseries is the abstract superclass representing any type of timeseries data. |
CompositeTimeseries |
A CompositeTimeseries is a (possibly recursive) aggregation of atomic and composite timeseries. The components of a composite timeseries must have non-overlapping time intervals. |
Dynamizer |
A Dynamizer is an object that injects timeseries data for an individual attribute of the city object in which it is included. The timeseries data overrides the static value of the referenced city object attribute in order to represent dynamic (time-dependent) variations of its value. |
GenericTimeseries |
A GenericTimeseries represents time-varying data in the form of embedded time-value-pairs of a specific data type for a single contiguous time interval. |
StandardFileTimeseries |
A StandardFileTimeseries represents time-varying data for a single contiguous time interval. The data is provided in an external file referenced in the StandardFileTimeseries. The data within the external file is encoded according to a dedicated format for the representation of timeseries data such as using the OGC TimeseriesML or OGC Observations & Measurements Standard. The data type of the data has to be specified within the external file. |
TabulatedFileTimeseries |
A TabulatedFileTimeseries represents time-varying data of a specific data type for a single contiguous time interval. The data is provided in an external file referenced in the TabulatedFileTimeseries. The file contains table structured data using an appropriate file format such as comma-separated values (CSV), Microsoft Excel (XLSX) or Google Spreadsheet. The timestamps and the values are given in specific columns of the table. Each row represents a single time-value-pair. A subset of rows can be selected using the idColumn and idValue attributes. |
Name |
Description |
ADEOfAbstractAtomicTimeseries |
ADEOfAbstractAtomicTimeseries acts as a hook to define properties within an ADE that are to be added to AbstractAtomicTimeseries. |
ADEOfAbstractTimeseries |
ADEOfAbstractTimeseries acts as a hook to define properties within an ADE that are to be added to AbstractTimeseries. |
ADEOfCompositeTimeseries |
ADEOfCompositeTimeseries acts as a hook to define properties within an ADE that are to be added to a CompositeTimeseries. |
ADEOfDynamizer |
ADEOfDynamizer acts as a hook to define properties within an ADE that are to be added to a Dynamizer. |
ADEOfGenericTimeseries |
ADEOfGenericTimeseries acts as a hook to define properties within an ADE that are to be added to a GenericTimeseries. |
ADEOfStandardFileTimeseries |
ADEOfStandardFileTimeseries acts as a hook to define properties within an ADE that are to be added to a StandardFileTimeseries. |
ADEOfTabulatedFileTimeseries |
ADEOfTabulatedFileTimeseries acts as a hook to define properties within an ADE that are to be added to a TabulatedFileTimeseries. |
SensorConnection |
A SensorConnection provides all details that are required to retrieve a specific datastream from an external sensor web service. This data type comprises the service type (e.g. OGC SensorThings API, OGC Sensor Observation Services, MQTT, proprietary platforms), the URL of the sensor service, the identifier for the sensor or thing, and its observed property as well as information about the required authentication method. |
TimeseriesComponent |
TimeseriesComponent represents an element of a CompositeTimeseries. |
TimeValuePair |
A TimeValuePair represents a value that is valid for a given timepoint. For each TimeValuePair, only one of the value properties can be used mutually exclusive. Which value property has to be provided depends on the selected value type in the GenericTimeSeries feature, in which the TimeValuePair is included. |
Name |
Description |
TimeseriesTypeValue |
TimeseriesTypeValue enumerates the possible value types for GenericTimeseries and TimeValuePair. |
Name |
Description |
AuthenticationTypeValue |
AuthenticationTypeValue is a code list used to specify the authentication method to be used to access the referenced sensor service. Each value provides enough information such that a software application could determine the required access credentials. |
SensorConnectionTypeValue |
SensorConnectionTypeValue is a code list used to specify the type of the referenced sensor service. Each value provides enough information such that a software application would be able to identify the API type and version. |
StandardFileTypeValue |
StandardFileTypeValue is a code list used to specify the type of the referenced external timeseries data file. Each value provides information about the standard and version. |
TabulatedFileTypeValue |
TabulatedFileTypeValue is a code list used to specify the data format of the referenced external tabulated data file. |
8.6.3. Additional Information
Additional information about the Dynamizer Module can be found in the OGC CityGML 3.0 Users Guide
8.7. Generics
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-generics |
|
Target type |
Implementation Specification |
Dependency |
|
The Generics module provides the representation of generic city objects. These are city objects that are not covered by any explicitly modelled thematic class within the CityGML Conceptual Model. The Generics module also provides the representation of generic attributes which are attributes that are not explicitly represented in the CityGML Conceptual Model. In order to avoid problems concerning semantic interoperability, generic city objects and generic attributes shall only be used if appropriate thematic classes and attributes are not provided by any other CityGML module.
In accordance with the CityGML Space concept defined in the Core module (cf. Section Core) generic city objects can be represented as generic logical spaces, generic occupied spaces, generic unoccupied spaces, and generic thematic surfaces. In this way, spaces and surfaces can be defined that are not represented by any explicitly modelled class within CityGML that is a subclass of the classes AbstractLogicalSpace, AbstractOccupiedSpace, AbstractUnoccupiedSpace or AbstractThematicSurface, respectively. Generic city objects are represented in the UML model by the top-level feature types GenericLogicalSpace, GenericOccupiedSpace, GenericUnoccupiedSpace and GenericThematicSurface.
Generic attributes are defined as name-value pairs and are always associated with a city object. Generic attributes can be of type String, Integer, Double, Date, URI, Measure, and Code. In addition, generic attributes can be grouped under a common name as generic attribute sets.
The UML diagram of the Generics module is depicted in Figure 32. A detailed discussion of this Requirements Class can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Generics module are illustrated in Figure 33.
The Code Lists provided for the Generics module are illustrated in Figure 34.
Table 31 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Generics module:
Space class |
Allowed space boundaries |
GenericLogicalSpace |
|
GenericOccupiedSpace |
|
GenericUnoccupiedSpace |
|
8.7.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Generics Module as an Implementation Specification.
Requirement 15 |
/req/generics/classes |
For each UML class defined or referenced in the Generics Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 16 |
/req/generics/boundaries |
Table 31 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Generics module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 31 |
|
The decision of whether or not to use Generics is constrained by the following requirement:
Requirement 17 |
/req/generics/use |
Generic objects and attributes SHALL only be used if a more specific feature class or attribute is not available from the CityGML conceptual model. |
|
The use of extension capabilities by Generics elements is constrained by the following requirement:
Requirement 18 |
/req/generics/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.7.2. Class Definitions
Class |
Description |
GenericLogicalSpace |
A GenericLogicalSpace is a space that is not represented by any explicitly modelled AbstractLogicalSpace subclass within CityGML. |
GenericOccupiedSpace |
A GenericOccupiedSpace is a space that is not represented by any explicitly modelled AbstractOccupiedSpace subclass within CityGML. |
GenericThematicSurface |
A GenericThematicSurface is a surface that is not represented by any explicitly modelled AbstractThematicSurface subclass within CityGML. |
GenericUnoccupiedSpace |
A GenericUnoccupiedSpace is a space that is not represented by any explicitly modelled AbstractUnoccupiedSpace subclass within CityGML. |
Name |
Description |
ADEOfGenericLogicalSpace |
ADEOfGenericLogicalSpace acts as a hook to define properties within an ADE that are to be added to a GenericLogicalSpace. |
ADEOfGenericOccupiedSpace |
ADEOfGenericOccupiedSpace acts as a hook to define properties within an ADE that are to be added to a GenericOccupiedSpace. |
ADEOfGenericThematicSurface |
ADEOfGenericThematicSurface acts as a hook to define properties within an ADE that are to be added to a GenericThematicSurface. |
ADEOfGenericUnoccupiedSpace |
ADEOfGenericUnoccupiedSpace acts as a hook to define properties within an ADE that are to be added to a GenericUnoccupiedSpace. |
CodeAttribute |
CodeAttribute is a data type used to define generic attributes of type "Code". |
DateAttribute |
DateAttribute is a data type used to define generic attributes of type "Date". |
DoubleAttribute |
DoubleAttribute is a data type used to define generic attributes of type "Double". |
GenericAttributeSet |
A GenericAttributeSet is a named collection of generic attributes. |
IntAttribute |
IntAttribute is a data type used to define generic attributes of type "Integer". |
MeasureAttribute |
MeasureAttribute is a data type used to define generic attributes of type "Measure". |
StringAttribute |
StringAttribute is a data type used to define generic attributes of type "String". |
UriAttribute |
UriAttribute is a data type used to define generic attributes of type "URI". |
Name |
Description |
GenericLogicalSpaceClassValue |
GenericLogicalSpaceClassValue is a code list used to further classify a GenericLogicalSpace. |
GenericLogicalSpaceFunctionValue |
GenericLogicalSpaceFunctionValue is a code list that enumerates the different purposes of a GenericLogicalSpace. |
GenericLogicalSpaceUsageValue |
GenericLogicalSpaceUsageValue is a code list that enumerates the different uses of a GenericLogicalSpace. |
GenericOccupiedSpaceClassValue |
GenericOccupiedSpaceClassValue is a code list used to further classify a GenericOccupiedSpace. |
GenericOccupiedSpaceFunctionValue |
GenericOccupiedSpaceFunctionValue is a code list that enumerates the different purposes of a GenericOccupiedSpace. |
GenericOccupiedSpaceUsageValue |
GenericOccupiedSpaceUsageValue is a code list that enumerates the different uses of a GenericOccupiedSpace. |
GenericThematicSurfaceClassValue |
GenericThematicSurfaceClassValue is a code list used to further classify a GenericThematicSurface. |
GenericThematicSurfaceFunctionValue |
GenericThematicSurfaceFunctionValue is a code list that enumerates the different purposes of a GenericThematicSurface. |
GenericThematicSurfaceUsageValue |
GenericThematicSurfaceUsageValue is a code list that enumerates the different uses of a GenericThematicSurface. |
GenericUnoccupiedSpaceClassValue |
GenericUnoccupiedSpaceClassValue is a code list used to further classify a GenericUnoccupiedSpace. |
GenericUnoccupiedSpaceFunctionValue |
GenericUnoccupiedSpaceFunctionValue is a code list that enumerates the different purposes of a GenericUnoccupiedSpace. |
GenericUnoccupiedSpaceUsageValue |
GenericUnoccupiedSpaceUsageValue is a code list that enumerates the different uses of a GenericUnoccupiedSpace. |
8.7.3. Additional Information
Additional information about the Generics Module can be found in the OGC CityGML 3.0 Users Guide
8.8. Land Use
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-landuse |
|
Target type |
Implementation Specification |
Dependency |
|
The LandUse module defines objects that can be used to describe areas of the earth’s surface dedicated to a specific land use or having a specific land cover with or without vegetation, such as sand, rock, mud flats, forest, grasslands, or wetlands (i.e. the physical appearance). Land use and land cover are different concepts. The first describes human activities on the earth’s surface, the second describes its physical and biological cover. However, the two concepts are interlinked and often mixed in practice. Land use objects in CityGML support both concepts: They can be employed to represent parcels, spatial planning objects, recreational objects, and objects describing the physical characteristics of an area in 3D. Land use objects are represented in the UML model by the top-level feature type LandUse, which is also the only class of the LandUse module.
The UML diagram of the LandUse module is depicted in Figure 35. A detailed discussion of this Requirements Class can be found in the CityGML User Guide.
The ADE data types provided for the Land Use module are illustrated in Figure 36.
The Code Lists provided for the Land Use module are illustrated in Figure 37.
8.8.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Land Use Module as an Implementation Specification.
Requirement 19 |
/req/landuse/classes |
For each UML class defined or referenced in the LandUse Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The use of extension capabilities by Land Use elements is constrained by the following requirement:
Requirement 20 |
/req/landuse/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.8.2. Class Definitions
Class |
Description |
LandUse |
A LandUse object is an area of the earth’s surface dedicated to a specific land use or having a specific land cover with or without vegetation, such as sand, rock, mud flats, forest, grasslands, or wetlands. |
Name |
Description |
ADEOfLandUse |
ADEOfLandUse acts as a hook to define properties within an ADE that are to be added to a LandUse. |
Name |
Description |
LandUseClassValue |
LandUseClassValue is a code list used to further classify a LandUse. |
LandUseFunctionValue |
LandUseFunctionValue is a code list that enumerates the different purposes of a LandUse. |
LandUseUsageValue |
LandUseUsageValue is a code list that enumerates the different uses of a LandUse. |
8.8.3. Additional Information
Additional information about the Land Use Module can be found in the OGC CityGML 3.0 Users Guide
8.9. Point Cloud
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-pointcloud |
|
Target type |
Implementation Specification |
Dependency |
|
The PointCloud module specifies how to encode the geometry of physical spaces and of thematic surfaces as 3D point clouds. In this way, the building hull, a room within a building or a single wall surface can be spatially represented by a point cloud only. The same applies to all other thematic feature types including transportation objects, vegetation, city furniture, etc. Point clouds can either be provided inline within a CityGML file or as reference to external point cloud files of common file types such as LAS or LAZ. Point clouds are represented in the UML model by the feature type PointCloud, which is also the only class of the PointCloud module.
The UML diagram of the PointCloud module is depicted in Figure 38. A detailed discussion of this Requirements Class can be found in the CityGML User Guide.
The ADE data types provided for the Point Cloud module are illustrated in Figure 39.
8.9.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Point Cloud Module as an Implementation Specification.
Requirement 21 |
/req/pointcloud/classes |
For each UML class defined or referenced in the PointCloud Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The use of extension capabilities by Point Cloud elements is constrained by the following requirement:
Requirement 22 |
/req/pointcloud/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.9.2. Class Definitions
Class |
Description |
PointCloud |
A PointCloud is an unordered collection of points that is a sampling of the geometry of a space or space boundary. |
ADEOfPointCloud |
ADEOfPointCloud acts as a hook to define properties within an ADE that are to be added to a PointCloud. |
8.9.3. Additional Information
Additional information about the Point Cloud Module can be found in the OGC CityGML 3.0 Users Guide
8.10. Relief
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-relief |
|
Target type |
Implementation Specification |
Dependency |
|
The Relief module provides the representation of terrain which is an essential part of city models. In CityGML, the terrain is modelled by relief features. They are represented in the UML model by the top-level feature type ReliefFeature, which is the main class of the Relief module. The relief features, in turn, are collections of relief components that describe the Earth’s surface, also known as the Digital Terrain Model. The relief components can have different terrain representations which can coexist. Each relief component may be specified as a regular raster or grid, as a TIN (Triangulated Irregular Network), by break lines, or by mass points. In addition, the validity of the relief components may be restricted to certain areas.
The UML diagram of the Relief module is depicted in Figure 40. A detailed discussion of this Requirements Class can be found in the CityGML User Guide.
The ADE data types provided for the Relief module are illustrated in Figure 41.
8.10.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Relief Module as an Implementation Specification.
Requirement 23 |
/req/relief/classes |
For each UML class defined or referenced in the Relief Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The use of extension capabilities by Relief elements is constrained by the following requirement:
Requirement 24 |
/req/relief/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.10.2. Class Definitions
Class |
Description |
ReliefFeature |
A ReliefFeature is a collection of terrain components representing the Earth’s surface, also known as the Digital Terrain Model. |
AbstractReliefComponent |
An AbstractReliefComponent represents an element of the terrain surface - either a TIN, a raster or grid, mass points or break lines. |
BreaklineRelief |
A BreaklineRelief represents a terrain component with 3D lines. These lines denote break lines or ridge/valley lines. |
MassPointRelief |
A MassPointRelief represents a terrain component as a collection of 3D points. |
RasterRelief |
A RasterRelief represents a terrain component as a regular raster or grid. |
TINRelief |
A TINRelief represents a terrain component as a triangulated irregular network. |
Name |
Description |
ADEOfAbstractReliefComponent |
ADEOfAbstractReliefComponent acts as a hook to define properties within an ADE that are to be added to AbstractReliefComponent. |
ADEOfBreaklineRelief |
ADEOfBreaklineRelief acts as a hook to define properties within an ADE that are to be added to a BreaklineRelief. |
ADEOfMassPointRelief |
ADEOfMassPointRelief acts as a hook to define properties within an ADE that are to be added to a MassPointRelief. |
ADEOfRasterRelief |
ADEOfRasterRelief acts as a hook to define properties within an ADE that are to be added to a RasterRelief. |
ADEOfReliefFeature |
ADEOfReliefFeature acts as a hook to define properties within an ADE that are to be added to a ReliefFeature. |
ADEOfTINRelief |
ADEOfTINRelief acts as a hook to define properties within an ADE that are to be added to a TINRelief. |
8.10.3. Additional Information
Additional information about the Relief Module can be found in the OGC CityGML 3.0 Users Guide
8.11. Transportation
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-transportation |
|
Target type |
Implementation Specification |
Dependency |
|
The Transportation module defines central elements of the traffic infrastructure. This includes the transportation objects road, track, and square for the movement of vehicles, bicycles, and pedestrians, the transportation object railway for the movement of wheeled vehicles on rails, as well as the transportation object waterway for the movement of vessels upon or within water bodies. The transportation objects are represented in the UML model by the top-level feature types Road, Track, Square, Railway, and Waterway, which are the main classes of the Transportation module. Transportation objects can be subdivided into sections, which can be regular road, track or railway legs, into intersection areas, and into roundabouts.
For each transportation object, traffic spaces and auxiliary traffic spaces can be provided, which are bounded at the bottom by traffic areas and auxiliary traffic areas, respectively. Traffic areas are elements that are important in terms of traffic usage, such as driving lanes, sidewalks, and cycle lanes, whereas auxiliary traffic areas describe further elements, such as curbstones, middle lanes, and green areas. The corresponding spaces define the free space above the areas. In addition, each traffic space can have an optional clearance space. The transportation objects can be represented in different levels of granularity, either as a single area, split up into individual lanes or even decomposed into individual (carriage)ways. Furthermore, holes in the surfaces of roads, tracks or squares, such as road damages, manholes or drains, can be represented including their corresponding boundary surfaces. In addition, markings for the structuring or restriction of traffic can be added to the transportation areas. Examples are road markings and markings related to railway or waterway traffic.
The UML diagram of the Transportation module is depicted in Figure 42. A detailed discussion of this Requirements Class can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Transportation module are illustrated in Figure 43.
The Code Lists provided for the Transportation module are illustrated in Figure 44.
Table 41 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Transportation module:
Space class |
Allowed space boundaries |
AbstractTransportationSpace |
|
AuxiliaryTrafficSpace |
|
ClearanceSpace |
|
Hole |
|
Intersection |
|
Railway |
|
Road |
|
Section |
|
Square |
|
Track |
|
TrafficSpace |
|
Waterway |
|
8.11.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Transportation Module as an Implementation Specification.
Requirement 25 |
/req/transportation/classes |
For each UML class defined or referenced in the Transportation Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 26 |
/req/transportation/boundaries |
Table 41 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Transportation module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 41 |
|
The use of extension capabilities by Transportation elements is constrained by the following requirement:
Requirement 27 |
/req/transportation/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.11.2. Class Definitions
Class |
Description |
Railway |
A Railway is a transportation space used by wheeled vehicles on rails. |
Road |
A Road is a transportation space used by vehicles, bicycles and/or pedestrians. |
Square |
A Square is a transportation space for unrestricted movement for vehicles, bicycles and/or pedestrians. This includes plazas as well as large sealed surfaces such as parking lots. |
Track |
A Track is a small path mainly used by pedestrians. Tracks can be segmented into Sections and Intersections. |
Waterway |
A Waterway is a transportation space used for the movement of vessels upon or within a water body. |
AbstractTransportationSpace |
AbstractTransportationSpace is the abstract superclass of transportation objects such as Roads, Tracks, Railways, Waterways or Squares. |
AuxiliaryTrafficArea |
An AuxiliaryTrafficArea is the ground surface of an AuxiliaryTrafficSpace. |
AuxiliaryTrafficSpace |
An AuxiliaryTrafficSpace is a space within the transportation space not intended for traffic purposes. |
ClearanceSpace |
A ClearanceSpace represents the actual free space above a TrafficArea within which a mobile object can move without contacting an obstruction. |
Hole |
A Hole is an opening in the surface of a Road, Track or Square such as road damages, manholes or drains. Holes can span multiple transportation objects. |
HoleSurface |
A HoleSurface is a representation of the ground surface of a hole. |
Intersection |
An Intersection is a transportation space that is a shared segment of multiple Road, Track, Railway, or Waterway objects (e.g. a crossing of two roads or a level crossing of a road and a railway). |
Marking |
A Marking is a visible pattern on a transportation area relevant to the structuring or restriction of traffic. Examples are road markings and markings related to railway or waterway traffic. |
Section |
A Section is a transportation space that is a segment of a Road, Railway, Track, or Waterway. |
TrafficArea |
A TrafficArea is the ground surface of a TrafficSpace. Traffic areas are the surfaces upon which traffic actually takes place. |
TrafficSpace |
A TrafficSpace is a space in which traffic takes place. Traffic includes the movement of entities such as trains, vehicles, pedestrians, ships, or other transportation types. |
Name |
Description |
ADEOfAbstractTransportationSpace |
ADEOfAbstractTransportationSpace acts as a hook to define properties within an ADE that are to be added to AbstractTransportationSpace. |
ADEOfAuxiliaryTrafficArea |
ADEOfAuxiliaryTrafficArea acts as a hook to define properties within an ADE that are to be added to an AuxiliaryTrafficArea. |
ADEOfAuxiliaryTrafficSpace |
ADEOfAuxiliaryTrafficSpace acts as a hook to define properties within an ADE that are to be added to an AuxiliaryTrafficSpace. |
ADEOfClearanceSpace |
ADEOfClearanceSpace acts as a hook to define properties within an ADE that are to be added to a ClearanceSpace. |
ADEOfHole |
ADEOfHole acts as a hook to define properties within an ADE that are to be added to a Hole. |
ADEOfHoleSurface |
ADEOfHoleSurface acts as a hook to define properties within an ADE that are to be added to a HoleSurface. |
ADEOfIntersection |
ADEOfIntersection acts as a hook to define properties within an ADE that are to be added to an Intersection. |
ADEOfMarking |
ADEOfMarking acts as a hook to define properties within an ADE that are to be added to a Marking. |
ADEOfRailway |
ADEOfRailway acts as a hook to define properties within an ADE that are to be added to a Railway. |
ADEOfRoad |
ADEOfRoad acts as a hook to define properties within an ADE that are to be added to a Road. |
ADEOfSection |
ADEOfSection acts as a hook to define properties within an ADE that are to be added to a Section. |
ADEOfSquare |
ADEOfSquare acts as a hook to define properties within an ADE that are to be added to a Square. |
ADEOfTrack |
ADEOfTrack acts as a hook to define properties within an ADE that are to be added to a Track. |
ADEOfTrafficArea |
ADEOfTrafficArea acts as a hook to define properties within an ADE that are to be added to a TrafficArea. |
ADEOfTrafficSpace |
ADEOfTrafficSpace acts as a hook to define properties within an ADE that are to be added to a TrafficSpace. |
ADEOfWaterway |
ADEOfWaterway acts as a hook to define properties within an ADE that are to be added to a Waterway. |
Name |
Description |
GranularityValue |
GranularityValue enumerates the different levels of granularity in which transportation objects are represented. |
TrafficDirectionValue |
TrafficDirectionValue enumerates the allowed directions of travel of a mobile object. |
Name |
Description |
AuxiliaryTrafficAreaClassValue |
AuxiliaryTrafficAreaClassValue is a code list used to further classify an AuxiliaryTrafficArea. |
AuxiliaryTrafficAreaFunctionValue |
AuxiliaryTrafficAreaFunctionValue is a code list that enumerates the different purposes of an AuxiliaryTrafficArea. |
AuxiliaryTrafficAreaUsageValue |
AuxiliaryTrafficAreaUsageValue is a code list that enumerates the different uses of an AuxiliaryTrafficArea. |
AuxiliaryTrafficSpaceClassValue |
AuxiliaryTrafficSpaceClassValue is a code list used to further classify an AuxiliaryTrafficSpace. |
AuxiliaryTrafficSpaceFunctionValue |
AuxiliaryTrafficSpaceFunctionValue is a code list that enumerates the different purposes of an AuxiliaryTrafficSpace. |
AuxiliaryTrafficSpaceUsageValue |
AuxiliaryTrafficSpaceUsageValue is a code list that enumerates the different uses of an AuxiliaryTrafficSpace. |
ClearanceSpaceClassValue |
ClearanceSpaceClassValue is a code list used to further classify a ClearanceSpace. |
HoleClassValue |
HoleClassValue is a code list used to further classify a Hole. |
IntersectionClassValue |
IntersectionClassValue is a code list used to further classify an Intersection. |
MarkingClassValue |
MarkingClassValue is a code list used to further classify a Marking. |
RailwayClassValue |
RailwayClassValue is a code list used to further classify a Railway. |
RailwayFunctionValue |
RailwayFunctionValue is a code list that enumerates the different purposes of a Railway. |
RailwayUsageValue |
RailwayUsageValue is a code list that enumerates the different uses of a Railway. |
RoadClassValue |
RoadClassValue is a code list used to further classify a Road. |
RoadFunctionValue |
RoadFunctionValue is a code list that enumerates the different purposes of a Road. |
RoadUsageValue |
RoadUsageValue is a code list that enumerates the different uses of a Road. |
SectionClassValue |
SectionClassValue is a code list used to further classify a Section. |
SquareClassValue |
SquareClassValue is a code list used to further classify a Square. |
SquareFunctionValue |
SquareFunctionValue is a code list that enumerates the different purposes of a Square. |
SquareUsageValue |
SquareUsageValue is a code list that enumerates the different uses of a Square. |
SurfaceMaterialValue |
SurfaceMaterialValue is a code list that enumerates the different surface materials. |
TrackClassValue |
TrackClassValue is a code list used to further classify a Track. |
TrackFunctionValue |
TrackFunctionValue is a code list that enumerates the different purposes of a Track. |
TrackUsageValue |
TrackUsageValue is a code list that enumerates the different uses of a Track. |
TrafficAreaClassValue |
TrafficAreaClassValue is a code list used to further classify a TrafficArea. |
TrafficAreaFunctionValue |
TrafficAreaFunctionValue is a code list that enumerates the different purposes of a TrafficArea. |
TrafficAreaUsageValue |
TrafficAreaUsageValue is a code list that enumerates the different uses of a TrafficArea. |
TrafficSpaceClassValue |
TrafficSpaceClassValue is a code list used to further classify a TrafficSpace. |
TrafficSpaceFunctionValue |
TrafficSpaceFunctionValue is a code list that enumerates the different purposes of a TrafficSpace. |
TrafficSpaceUsageValue |
TrafficSpaceUsageValue is a code list that enumerates the different uses of a TrafficSpace. |
WaterwayClassValue |
WaterwayClassValue is a code list used to further classify a Waterway. |
WaterwayFunctionValue |
WaterwayFunctionValue is a code list that enumerates the different purposes of a Waterway. |
WaterwayUsageValue |
WaterwayUsageValue is a code list that enumerates the different uses of a Waterway. |
8.11.3. Additional Information
Additional information about the Transportation Module can be found in the OGC CityGML 3.0 Users Guide
8.12. Vegetation
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-vegetation |
|
Target type |
Implementation Specification |
Dependency |
|
The Vegetation module defines the concepts to represent vegetation within city models. Vegetation can be represented either as solitary vegetation objects, such as trees, bushes and ferns, or as vegetation areas that are covered by plants of a given species or a typical mixture of plant species, such as forests, steppes and wet meadows. Vegetation is represented in the UML model by the top-level feature types SolitaryVegetationObject and PlantCover, which are also the only classes of the Vegetation module.
The UML diagram of the Vegetation module is depicted in Figure 45. A detailed discussion of this Requirements Class can be found in the CityGML User Guide.
The ADE data types provided for the Vegetation module are illustrated in Figure 46.
The Code Lists provided for the Vegetation module are illustrated in Figure 47.
Table 46 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Vegetation module.
Space class |
Allowed space boundaries |
AbstractVegetationObject |
No boundaries allowed |
PlantCover |
No boundaries allowed |
SolitaryVegetationObject |
No boundaries allowed |
8.12.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Vegetation Module as an Implementation Specification.
Requirement 28 |
/req/vegetation/classes |
For each UML class defined or referenced in the Vegetation Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 29 |
/req/vegetation/boundaries |
Table 46 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Vegetation module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 46 |
|
The use of extension capabilities by Vegetation elements is constrained by the following requirement:
Requirement 30 |
/req/vegetation/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.12.2. Class Definitions
Class |
Description |
PlantCover |
A PlantCover represents a space covered by vegetation. |
SolitaryVegetationObject |
A SolitaryVegetationObject represents individual vegetation objects, e.g. trees or bushes. |
AbstractVegetationObject |
AbstractVegetationObject is the abstract superclass for all kinds of vegetation objects. |
Name |
Description |
ADEOfAbstractVegetationObject |
ADEOfAbstractVegetationObject acts as a hook to define properties within an ADE that are to be added to AbstractVegetationObject. |
ADEOfPlantCover |
ADEOfPlantCover acts as a hook to define properties within an ADE that are to be added to a PlantCover. |
ADEOfSolitaryVegetationObject |
ADEOfSolitaryVegetationObject acts as a hook to define properties within an ADE that are to be added to a SolitaryVegetationObject. |
Name |
Description |
PlantCoverClassValue |
PlantCoverClassValue is a code list used to further classify a PlantCover. |
PlantCoverFunctionValue |
PlantCoverFunctionValue is a code list that enumerates the different purposes of a PlantCover. |
PlantCoverUsageValue |
PlantCoverUsageValue is a code list that enumerates the different uses of a PlantCover. |
SolitaryVegetationObjectClassValue |
SolitaryVegetationObjectClassValue is a code list used to further classify a SolitaryVegetationObject. |
SolitaryVegetationObjectFunctionValue |
SolitaryVegetationObjectFunctionValue is a code list that enumerates the different purposes of a SolitaryVegetationObject. |
SolitaryVegetationObjectUsageValue |
SolitaryVegetationObjectUsageValue is a code list that enumerates the different uses of a SolitaryVegetationObject. |
SpeciesValue |
A SpeciesValue is a code list that enumerates the species of a SolitaryVegetationObject. |
8.12.3. Additional Information
Additional information about the Transportation Module can be found in the OGC CityGML 3.0 Users Guide
8.13. Versioning
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-versioning |
|
Target type |
Implementation Specification |
Dependency |
|
The Versioning module defines the concepts that enable encoding representing multiple versions of a city model. A specific version represents a defined state of a city model consisting of the dedicated versions of all city object instances that belong to the respective city model version. Each version can be complemented by version transitions that describe the change of the state of a city model from one version to another and that give the reason for the change and the modifications applied. In addition, the Versioning module introduces bitemporal timestamps for all objects. This allows for providing all objects with information on 1) the time period a specific version of an object is an integral part of the 3D city model and 2) the lifespan a specific version of an object exists in the real world.
By using the Versioning module, slow changes over a long time period with respect to cities and city models can be represented. This includes the creation and termination of objects (e.g. construction or demolition of sites, planting of trees, construction of new roads), structural changes of objects, and changes in the status of an object (e.g. change of building owner, change of the traffic direction of a road to a one-way street). In this way, the history or evolution of cities and city models can be modelled, parallel or alternative versions of cities and city models can be managed, and changes of geometries and thematic properties of individual city objects over time can be tracked.
The UML diagram of the Versioning module is depicted in Figure 48. A detailed discussion of this Requirements Class can be found in the CityGML User Guide.
The ADE data types provided for the Versioning module are illustrated in Figure 49.
8.13.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Versioning Module as an Implementation Specification.
Requirement 31 |
/req/versioning/classes |
For each UML class defined or referenced in the Versioning Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The use of extension capabilities by Versioning elements is constrained by the following requirement:
Requirement 32 |
/req/versioning/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.13.2. Class Definitions
Class |
Description |
Version |
Version represents a defined state of a city model consisting of the dedicated versions of all city object instances that belong to the respective city model version. Versions can have names, a description and can be labeled with an arbitrary number of user defined tags. |
VersionTransition |
VersionTransition describes the change of the state of a city model from one version to another. Version transitions can have names, a description and can be further qualified by a type and a reason. |
Name |
Description |
ADEOfVersion |
ADEOfVersion acts as a hook to define properties within an ADE that are to be added to a Version. |
ADEOfVersionTransition |
ADEOfVersionTransition acts as a hook to define properties within an ADE that are to be added to a VersionTransition. |
Transaction |
Transaction represents a modification of the city model by the creation, termination, or replacement of a specific city object. While the creation of a city object also marks its first object version, the termination marks the end of existence of a real world object and, hence, also terminates the final version of a city object. The replacement of a city object means that a specific version of it is replaced by a new version. |
Name |
Description |
TransactionTypeValue |
TransactionTypeValue enumerates the three possible types of transactions: insert, delete, or replace. |
TransitionTypeValue |
TransitionTypeValue enumerates the different kinds of version transitions. “planned” and “fork” should be used in cases when from one city model version multiple successor versions are being created. “realized” and “merge” should be used when different city model versions are converging into a common successor version. |
8.13.3. Additional Information
Additional information about the Transportation Module can be found in the OGC CityGML 3.0 Users Guide
8.14. Water Body
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-waterbody |
|
Target type |
Implementation Specification |
Dependency |
|
The WaterBody module provides the representation of significant and permanent or semi-permanent accumulations of surface water, usually covering a part of the Earth. Examples of such water bodies that can be modelled with CityGML are rivers, canals, lakes, and basins. Water bodies are represented in the UML model by the top-level feature type WaterBody, which is the main class of the WaterBody module.
Water bodies can be bounded by water surfaces, which represent the upper exterior interface between the water body and the atmosphere, and by water ground surfaces, which represent the exterior boundary surfaces of the submerged bottom of a water body (e.g. DTM or floor of a 3D basin object). Water surfaces are dynamic surfaces, thus, the visible water surface can regularly as well as irregularly change in height and covered area due to natural forces such as tides and floods.
The UML diagram of the WaterBody module is depicted in Figure 50. A detailed discussion of this Requirements Class can be found in the CityGML User Guide.
The ADE data types provided for the Water Body module are illustrated in Figure 51.
The Code Lists provided for the Water Body module are illustrated in Figure 52.
Table 53 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the WaterBody module:
Space class |
Allowed space boundaries |
WaterBody |
|
8.14.1. Requirements
The following requirement defines the rules governing implementation of the CityGML WaterBody Module as an Implementation Specification.
Requirement 33 |
/req/waterbody/classes |
For each UML class defined or referenced in the Waterbody Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 34 |
/req/waterbody/boundaries |
Table 53 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Waterbody module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 53 |
|
The use of extension capabilities by Waterbody elements is constrained by the following requirement:
Requirement 35 |
/req/waterbody/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.14.2. Class Definitions
Class |
Description |
WaterBody |
A WaterBody represents significant and permanent or semi-permanent accumulations of surface water, usually covering a part of the Earth. |
AbstractWaterBoundarySurface |
AbstractWaterBoundarySurface is the abstract superclass for all kinds of thematic surfaces bounding a water body. |
WaterGroundSurface |
A WaterGroundSurface represents the exterior boundary surface of the submerged bottom of a water body. |
WaterSurface |
A WaterSurface represents the upper exterior interface between a water body and the atmosphere. |
Name |
Description |
ADEOfAbstractWaterBoundarySurface |
ADEOfAbstractWaterBoundarySurface acts as a hook to define properties within an ADE that are to be added to AbstractWaterBoundarySurface. |
ADEOfWaterBody |
ADEOfWaterBody acts as a hook to define properties within an ADE that are to be added to a WaterBody. |
ADEOfWaterGroundSurface |
ADEOfWaterGroundSurface acts as a hook to define properties within an ADE that are to be added to a WaterGroundSurface. |
ADEOfWaterSurface |
ADEOfWaterSurface acts as a hook to define properties within an ADE that are to be added to a WaterSurface. |
Name |
Description |
WaterBodyClassValue |
WaterBodyClassValue is a code list used to further classify a WaterBody. |
WaterBodyFunctionValue |
WaterBodyFunctionValue is a code list that enumerates the different purposes of a WaterBody. |
WaterBodyUsageValue |
WaterBodyUsageValue is a code list that enumerates the different uses of a WaterBody. |
WaterLevelValue |
WaterLevelValue is a code list that enumerates the different levels of a water surface. |
8.14.3. Additional Information
Additional information about the WaterBody Module can be found in the OGC CityGML 3.0 Users Guide
8.15. Construction
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-construction |
|
Target type |
Implementation Specification |
Dependency |
|
Dependency |
|
The Construction module defines concepts that are common to all forms of constructions. Constructions are objects that are manufactured by humans from construction materials, are connected to earth, and are intended to be permanent. The Construction module focuses on as-built representations of constructions and integrates all concepts that are similar over different types of constructions, in particular buildings, bridges, and tunnels. In addition, for representing man-made structures that are neither buildings, nor bridges, nor tunnels so-called other constructions (e.g. large chimneys or city walls) can be defined.
Furniture, installations, and constructive elements are further concepts that are defined in the Construction module. Installations are permanent parts of a construction that strongly affect the outer or inner appearance of the construction and that cannot be moved (e.g. balconies, chimneys, or stairs), whereas furniture represent moveable objects of a construction (e.g. tables and chairs). Constructive elements allow for decomposing a construction into volumetric components, such as walls, beams, and slabs. Constructions and constructive elements can be bounded by different types of surfaces. In this way, the outer structure of constructions and constructive elements can be differentiated semantically into wall surfaces, roof surfaces, ground surfaces, outer floor surfaces, and outer ceiling surfaces, whereas the visible surface of interior spaces can be structured into interior wall surfaces, floor surfaces, and ceiling surfaces. Furthermore, the openings of constructions, i.e. windows and doors, can be represented as so-called filling elements including their corresponding filling surfaces.
The UML diagram of the Construction module is depicted in Figure 53. The Construction module defines concepts that are inherited and, where necessary, are specialized by the modules Building, Bridge, and Tunnel (cf. Section 8.17, Section 8.16, and Section 8.18). A detailed discussion of the Requirements Class Construction can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Construction module are illustrated in Figure 54.
The Code Lists provided for the Construction module are illustrated in Figure 55.
Table 57 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Construction module:
Space class |
Allowed space boundaries |
AbstractConstruction |
|
AbstractConstructiveElement |
|
AbstractFillingElement |
No boundaries allowed |
AbstractFurniture |
No boundaries allowed |
AbstractInstallation |
|
Door |
|
OtherConstruction |
|
Window |
|
8.15.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Construction Module as an Implementation Specification.
Requirement 36 |
/req/construction/classes |
For each UML class defined or referenced in the Construction Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 37 |
/req/construction/boundaries |
Table 57 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Construction module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 57 |
|
The use of extension capabilities by Construction elements is constrained by the following requirement:
Requirement 38 |
/req/construction/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.15.2. Class Definitions
Class |
Description |
OtherConstruction |
An OtherConstruction is a construction that is not covered by any of the other subclasses of AbstractConstruction. |
AbstractConstruction |
AbstractConstruction is the abstract superclass for objects that are manufactured by humans from construction materials, are connected to earth, and are intended to be permanent. A connection with the ground also exists when the construction rests by its own weight on the ground or is moveable limited on stationary rails or if the construction is intended to be used mainly stationary. |
AbstractConstructionSurface |
AbstractConstructionSurface is the abstract superclass for different kinds of surfaces that bound a construction. |
AbstractConstructiveElement |
AbstractConstructiveElement is the abstract superclass for the representation of volumetric elements of a construction. Examples are walls, beams, slabs. |
AbstractFillingElement |
AbstractFillingElement is the abstract superclass for different kinds of elements that fill the openings of a construction. |
AbstractFillingSurface |
AbstractFillingSurface is the abstract superclass for different kinds of surfaces that seal openings filled by filling elements. |
AbstractFurniture |
AbstractFurniture is the abstract superclass for the representation of furniture objects of a construction. |
AbstractInstallation |
AbstractInstallation is the abstract superclass for the representation of installation objects of a construction. |
CeilingSurface |
A CeilingSurface is a surface that represents the interior ceiling of a construction. An example is the ceiling of a room. |
Door |
A Door is a construction for closing an opening intended primarily for access or egress or both. [cf. ISO 6707-1] |
DoorSurface |
A DoorSurface is either a boundary surface of a Door feature or a surface that seals an opening filled by a door. |
FloorSurface |
A FloorSurface is surface that represents the interior floor of a construction. An example is the floor of a room. |
GroundSurface |
A GroundSurface is a surface that represents the ground plate of a construction. The polygon defining the ground plate is congruent with the footprint of the construction. |
InteriorWallSurface |
An InteriorWallSurface is a surface that is visible from inside a construction. An example is the wall of a room. |
OuterCeilingSurface |
An OuterCeilingSurface is a surface that belongs to the outer building shell with the orientation pointing downwards. An example is the ceiling of a loggia. |
OuterFloorSurface |
An OuterFloorSurface is a surface that belongs to the outer construction shell with the orientation pointing upwards. An example is the floor of a loggia. |
RoofSurface |
A RoofSurface is a surface that delimits major roof parts of a construction. |
WallSurface |
A WallSurface is a surface that is part of the building facade visible from the outside. |
Window |
A Window is a construction for closing an opening in a wall or roof, primarily intended to admit light and/or provide ventilation. [cf. ISO 6707-1] |
WindowSurface |
A WindowSurface is either a boundary surface of a Window feature or a surface that seals an opening filled by a window. |
Name |
Description |
ADEOfAbstractConstruction |
ADEOfAbstractConstruction acts as a hook to define properties within an ADE that are to be added to AbstractConstruction. |
ADEOfAbstractConstructionSurface |
ADEOfAbstractConstructionSurface acts as a hook to define properties within an ADE that are to be added to AbstractConstructionSurface. |
ADEOfAbstractConstructiveElement |
ADEOfAbstractConstructiveElement acts as a hook to define properties within an ADE that are to be added to AbstractConstructiveElement. |
ADEOfAbstractFillingElement |
ADEOfAbstractFillingElement acts as a hook to define properties within an ADE that are to be added to AbstractFillingElement. |
ADEOfAbstractFillingSurface |
ADEOfAbstractFillingSurface acts as a hook to define properties within an ADE that are to be added to AbstractFillingSurface. |
ADEOfAbstractFurniture |
ADEOfAbstractFurniture acts as a hook to define properties within an ADE that are to be added to AbstractFurniture. |
ADEOfAbstractInstallation |
ADEOfAbstractInstallation acts as a hook to define properties within an ADE that are to be added to AbstractInstallation. |
ADEOfCeilingSurface |
ADEOfCeilingSurface acts as a hook to define properties within an ADE that are to be added to a CeilingSurface. |
ADEOfDoor |
ADEOfDoor acts as a hook to define properties within an ADE that are to be added to a Door. |
ADEOfDoorSurface |
ADEOfDoorSurface acts as a hook to define properties within an ADE that are to be added to a DoorSurface. |
ADEOfFloorSurface |
ADEOfFloorSurface acts as a hook to define properties within an ADE that are to be added to a FloorSurface. |
ADEOfGroundSurface |
ADEOfGroundSurface acts as a hook to define properties within an ADE that are to be added to a GroundSurface. |
ADEOfInteriorWallSurface |
ADEOfInteriorWallSurface acts as a hook to define properties within an ADE that are to be added to an InteriorWallSurface. |
ADEOfOtherConstruction |
ADEOfOtherConstruction acts as a hook to define properties within an ADE that are to be added to an OtherConstruction. |
ADEOfOuterCeilingSurface |
ADEOfOuterCeilingSurface acts as a hook to define properties within an ADE that are to be added to an OuterCeilingSurface. |
ADEOfOuterFloorSurface |
ADEOfOuterFloorSurface acts as a hook to define properties within an ADE that are to be added to an OuterFloorSurface. |
ADEOfRoofSurface |
ADEOfRoofSurface acts as a hook to define properties within an ADE that are to be added to a RoofSurface. |
ADEOfWallSurface |
ADEOfWallSurface acts as a hook to define properties within an ADE that are to be added to a WallSurface. |
ADEOfWindow |
ADEOfWindow acts as a hook to define properties within an ADE that are to be added to a Window. |
ADEOfWindowSurface |
ADEOfWindowSurface acts as a hook to define properties within an ADE that are to be added to a WindowSurface. |
ConstructionEvent |
A ConstructionEvent is a data type used to describe a specific event that is associated with a construction. Examples are the issuing of a building permit or the renovation of a building. |
Elevation |
Elevation is a data type that includes the elevation value itself and information on how this elevation was measured. [cf. INSPIRE] |
Height |
Height represents a vertical distance (measured or estimated) between a low reference and a high reference. [cf. INSPIRE] |
Name |
Description |
ConditionOfConstructionValue |
ConditionOfConstructionValue enumerates different conditions of a construction. [cf. INSPIRE] |
HeightStatusValue |
HeightStatusValue enumerates the different methods used to capture a height. [cf. INSPIRE] |
RelationToConstruction |
RelationToConstruction is an enumeration used to describe whether an installation is positioned inside and/or outside of a construction. |
Name |
Description |
DoorClassValue |
DoorClassValue is a code list used to further classify a Door. |
DoorFunctionValue |
DoorFunctionValue is a code list that enumerates the different purposes of a Door. |
DoorUsageValue |
DoorUsageValue is a code list that enumerates the different uses of a Door. |
ElevationReferenceValue |
ElevationReferenceValue is a code list that enumerates the different elevation reference levels used to measure construction heights. |
EventValue |
EventValue is a code list that enumerates the different events of a construction. |
OtherConstructionClassValue |
OtherConstructionClassValue is a code list used to further classify an OtherConstruction. |
OtherConstructionFunctionValue |
OtherConstructionFunctionValue is a code list that enumerates the different purposes of an OtherConstruction. |
OtherConstructionUsageValue |
OtherConstructionUsageValue is a code list that enumerates the different uses of an OtherConstruction. |
WindowClassValue |
WindowClassValue is a code list used to further classify a Window. |
WindowFunctionValue |
WindowFunctionValue is a code list that enumerates the different purposes of a Window. |
WindowUsageValue |
WindowUsageValue is a code list that enumerates the different uses of a Window. |
8.15.3. Additional Information
Additional information about the Construction Module can be found in the OGC CityGML 3.0 Users Guide
8.16. Bridge
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-bridge |
|
Target type |
Implementation Specification |
Dependency |
|
Dependency |
|
The Bridge module provides the representation of thematic and spatial aspects of bridges. Bridges are movable or unmovable structures that span intervening natural or built elements. In this way, bridges allow the passage of pedestrians, animals, vehicles, and service(s) above obstacles or between two points at a height above ground. Bridges are represented in the UML model by the top-level feature type Bridge, which is the main class of the Bridge module. Bridges can physically or functionally be subdivided into bridge parts. In addition, bridges can be decomposed into structural elements, such as pylons, anchorages, cables, slabs, and beams.
The free space inside bridges is represented by rooms, which allows a virtual accessibility of bridges. Bridges can contain installations and furniture. Installations are permanent parts of a bridge that strongly affect the outer or inner appearance of the bridge and that cannot be moved. Examples are stairways, signals, railings, and lamps. Furniture, in contrast, represent moveable objects of a bridge, like signs, art works, and benches. Bridges can be bounded by different types of surfaces. In this way, the outer structure of bridges can be differentiated semantically into wall surfaces, roof surfaces, ground surfaces, outer floor surfaces, and outer ceiling surfaces, whereas the visible surface of rooms can be structured into interior wall surfaces, floor surfaces, and ceiling surfaces. Furthermore, the openings of bridges, i.e. windows and doors, can be represented including their corresponding surfaces.
The UML diagram of the Bridge module is depicted in Figure 56. The Bridge module inherits concepts from the Construction module (cf. Section 8.15). The Construction module defines objects that are common to all types of construction, such as the different surface types and the openings. A detailed discussion of Requirements Class Bridge can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Bridge module are illustrated in Figure 57.
The Code Lists provided for the Bridge module are illustrated in Figure 58.
Table 62 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Bridge module:
Space class |
Allowed space boundaries |
AbstractBridge |
|
Bridge |
|
BridgeConstructiveElement |
|
BridgeFurniture |
No boundaries allowed |
BridgeInstallation |
|
BridgePart |
|
BridgeRoom |
|
8.16.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Bridge Module as an Implementation Specification.
Requirement 39 |
/req/bridge/classes |
For each UML class defined or referenced in the Bridge Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 40 |
/req/bridge/boundaries |
Table 62 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Bridge module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 62 |
|
The use of extension capabilities by Bridge elements is constrained by the following requirement:
Requirement 41 |
/req/bridge/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.16.2. Class Definitions
Class |
Description |
Bridge |
A Bridge represents a structure that affords the passage of pedestrians, animals, vehicles, and service(s) above obstacles or between two points at a height above ground. [cf. ISO 6707-1] |
AbstractBridge |
AbstractBridge is an abstract superclass representing the common attributes and associations of the classes Bridge and BridgePart. |
BridgeConstructiveElement |
A BridgeConstructiveElement is an element of a bridge which is essential from a structural point of view. Examples are pylons, anchorages, slabs, beams. |
BridgeFurniture |
A BridgeFurniture is an equipment for occupant use, usually not fixed to the bridge. [cf. ISO 6707-1] |
BridgeInstallation |
A BridgeInstallation is a permanent part of a Bridge (inside and/or outside) which does not have the significance of a BridgePart. In contrast to BridgeConstructiveElements, a BridgeInstallation is not essential from a structural point of view. Examples are stairs, antennas or railways. |
BridgePart |
A BridgePart is a physical or functional subdivision of a Bridge. It would be considered a Bridge, if it were not part of a collection of other BridgeParts. |
BridgeRoom |
A BridgeRoom is a space within a Bridge or BridgePart intended for human occupancy (e.g. a place of work or recreation) and/or containment (storage) of animals or things. A BridgeRoom is bounded physically and/or virtually (e.g. by ClosureSurfaces or GenericSurfaces). |
Name |
Description |
ADEOfAbstractBridge |
ADEOfAbstractBridge acts as a hook to define properties within an ADE that are to be added to AbstractBridge. |
ADEOfBridge |
ADEOfBridge acts as a hook to define properties within an ADE that are to be added to a Bridge. |
ADEOfBridgeConstructiveElement |
ADEOfBridgeConstructiveElement acts as a hook to define properties within an ADE that are to be added to a BridgeConstructiveElement. |
ADEOfBridgeFurniture |
ADEOfBridgeFurniture acts as a hook to define properties within an ADE that are to be added to a BridgeFurniture. |
ADEOfBridgeInstallation |
ADEOfBridgeInstallation acts as a hook to define properties within an ADE that are to be added to a BridgeInstallation. |
ADEOfBridgePart |
ADEOfBridgePart acts as a hook to define properties within an ADE that are to be added to a BridgePart. |
ADEOfBridgeRoom |
ADEOfBridgeRoom acts as a hook to define properties within an ADE that are to be added to a BridgeRoom. |
Name |
Description |
BridgeClassValue |
BridgeClassValue is a code list used to further classify a Bridge. |
BridgeConstructiveElementClassValue |
BridgeConstructiveElementClassValue is a code list used to further classify a BridgeConstructiveElement. |
BridgeConstructiveElementFunctionValue |
BridgeConstructiveElementFunctionValue is a code list that enumerates the different purposes of a BridgeConstructiveElement. |
BridgeConstructiveElementUsageValue |
BridgeConstructiveElementUsageValue is a code list that enumerates the different uses of a BridgeConstructiveElement. |
BridgeFunctionValue |
BridgeFunctionValue is a code list that enumerates the different purposes of a Bridge. |
BridgeFurnitureClassValue |
BridgeFurnitureClassValue is a code list used to further classify a BridgeFurniture. |
BridgeFurnitureFunctionValue |
BridgeFurnitureFunctionValue is a code list that enumerates the different purposes of a BridgeFurniture. |
BridgeFurnitureUsageValue |
BridgeFurnitureUsageValue is a code list that enumerates the different uses of a BridgeFurniture. |
BridgeInstallationClassValue |
BridgeInstallationClassValue is a code list used to further classify a BridgeInstallation. |
BridgeInstallationFunctionValue |
BridgeInstallationFunctionValue is a code list that enumerates the different purposes of a BridgeInstallation. |
BridgeInstallationUsageValue |
BridgeInstallationUsageValue is a code list that enumerates the different uses of a BridgeInstallation. |
BridgeRoomClassValue |
BridgeRoomClassValue is a code list used to further classify a BridgeRoom. |
BridgeRoomFunctionValue |
BridgeRoomFunctionValue is a code list that enumerates the different purposes of a BridgeRoom. |
BridgeRoomUsageValue |
BridgeRoomUsageValue is a code list that enumerates the different uses of a BridgeRoom. |
BridgeUsageValue |
BridgeUsageValue is a code list that enumerates the different uses of a Bridge. |
8.16.3. Additional Information
Additional information about the Bridge Module can be found in the OGC CityGML 3.0 Users Guide
8.17. Building
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-building |
|
Target type |
Implementation Specification |
Dependency |
|
Dependency |
|
The Building module provides the representation of thematic and spatial aspects of buildings. Buildings are free-standing, self-supporting constructions that are roofed and usually walled, and that can be entered by humans and are normally designed to stand permanently in one place. Buildings are intended for human occupancy (e.g. a place of work or recreation), habitation and/or shelter of humans, animals or things. Buildings are represented in the UML model by the top-level feature type Building, which is the main class of the Building module. Buildings can physically or functionally be subdivided into building parts, and logically into storeys and building units (e.g. apartments). In addition, buildings can be decomposed into structural elements, such as walls, slabs, staircases, and beams.
The interior of buildings is represented by rooms. This allows a virtual accessibility of buildings such as for visitor information in a museum (“Location Based Services“), the examination of accommodation standards or the presentation of daylight illumination of a building.
Buildings can contain installations and furniture. Installations are permanent parts of a building that strongly affect the outer or inner appearance of the building and that cannot be moved. Examples are balconies, chimneys, dormers or stairs. In contrast, Furniture, represents moveable objects inside a building, like tables and chairs.
Buildings can be bounded by different types of surfaces. In this way, the outer façade of buildings can be differentiated semantically into wall surfaces, roof surfaces, ground surfaces, outer floor surfaces, and outer ceiling surfaces, whereas the visible surface of rooms can be structured into interior wall surfaces, floor surfaces, and ceiling surfaces. Furthermore, the openings of buildings, i.e. windows and doors, can be represented including their corresponding surfaces.
The UML diagram of the building module is depicted in Figure 59. The Building module inherits concepts from the Construction module (cf. Section 8.15). The Construction module defines objects that are common to all types of construction, such as the different surface types and the openings. A detailed discussion of the Requirements Class Building can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Building module are illustrated in Figure 60.
The Code Lists provided for the Building module are illustrated in Figure 61.
Table 66 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Building module:
Space class |
Allowed space boundaries |
AbstractBuilding |
|
AbstractBuildingSubdivision |
No boundaries allowed |
Building |
|
BuildingConstructiveElement |
|
BuildingFurniture |
No boundaries allowed |
BuildingInstallation |
|
BuildingPart |
|
BuildingRoom |
|
BuildingUnit |
|
Storey |
|
8.17.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Building Module as an Implementation Specification.
Requirement 42 |
/req/building/classes |
For each UML class defined or referenced in the Building Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 43 |
/req/building/boundaries |
Table 66 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Building module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 66 |
|
The use of extension capabilities by Building elements is constrained by the following requirement:
Requirement 44 |
/req/building/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.17.2. Class Definitions
Class |
Description |
Building |
A Building is a free-standing, self-supporting construction that is roofed, usually walled, and can be entered by humans and is normally designed to stand permanently in one place. It is intended for human occupancy (e.g. a place of work or recreation), habitation and/or shelter of humans, animals or things. |
AbstractBuilding |
AbstractBuilding is an abstract superclass representing the common attributes and associations of the classes Building and BuildingPart. |
AbstractBuildingSubdivision |
AbstractBuildingSubdivision is the abstract superclass for different kinds of logical building subdivisions. |
BuildingConstructiveElement |
A BuildingConstructiveElement is an element of a Building which is essential from a structural point of view. Examples are walls, slabs, staircases, beams. |
BuildingFurniture |
A BuildingFurniture is an equipment for occupant use, usually not fixed to the building. [cf. ISO 6707-1] |
BuildingInstallation |
A BuildingInstallation is a permanent part of a Building (inside and/or outside) which has not the significance of a BuildingPart. Examples are stairs, antennas, balconies or small roofs. |
BuildingPart |
A BuildingPart is a physical or functional subdivision of a Building. It would be considered a Building, if it were not part of a collection of other BuildingParts. |
BuildingRoom |
A BuildingRoom is a space within a Building or BuildingPart intended for human occupancy (e.g. a place of work or recreation) and/or containment of animals or things. A BuildingRoom is bounded physically and/or virtually (e.g. by ClosureSurfaces or GenericSurfaces). |
BuildingUnit |
A BuildingUnit is a logical subdivision of a Building. BuildingUnits are formed according to some homogeneous property like function, ownership, management, or accessability. They may be separately sold, rented out, inherited, managed, etc. |
Storey |
A Storey is typically a horizontal section of a Building. Storeys are not always defined according to the building structure, but can also be defined according to logical considerations. |
Name |
Description |
ADEOfAbstractBuilding |
ADEOfAbstractBuilding acts as a hook to define properties within an ADE that are to be added to AbstractBuilding. |
ADEOfAbstractBuildingSubdivision |
ADEOfAbstractBuildingSubdivision acts as a hook to define properties within an ADE that are to be added to AbstractBuildingSubdivision. |
ADEOfBuilding |
ADEOfBuilding acts as a hook to define properties within an ADE that are to be added to a Building. |
ADEOfBuildingConstructiveElement |
ADEOfBuildingConstructiveElement acts as a hook to define properties within an ADE that are to be added to a BuildingConstructiveElement. |
ADEOfBuildingFurniture |
ADEOfBuildingFurniture acts as a hook to define properties within an ADE that are to be added to a BuildingFurniture. |
ADEOfBuildingInstallation |
ADEOfBuildingInstallation acts as a hook to define properties within an ADE that are to be added to a BuildingInstallation. |
ADEOfBuildingPart |
ADEOfBuildingPart acts as a hook to define properties within an ADE that are to be added to a BuildingPart. |
ADEOfBuildingRoom |
ADEOfBuildingRoom acts as a hook to define properties within an ADE that are to be added to a BuildingRoom. |
ADEOfBuildingUnit |
ADEOfBuildingUnit acts as a hook to define properties within an ADE that are to be added to a BuildingUnit. |
ADEOfStorey |
ADEOfStorey acts as a hook to define properties within an ADE that are to be added to a Storey. |
RoomHeight |
The RoomHeight represents a vertical distance (measured or estimated) between a low reference and a high reference. [cf. INSPIRE] |
Name |
Description |
BuildingClassValue |
BuildingClassValue is a code list used to further classify a Building. |
BuildingConstructiveElementClassValue |
BuildingConstructiveElementClassValue is a code list used to further classify a BuildingConstructiveElement. |
BuildingConstructiveElementFunctionValue |
BuildingConstructiveElementFunctionValue is a code list that enumerates the different purposes of a BuildingConstructiveElement. |
BuildingConstructiveElementUsageValue |
BuildingConstructiveElementUsageValue is a code list that enumerates the different uses of a BuildingConstructiveElement. |
BuildingFunctionValue |
BuildingFunctionValue is a code list that enumerates the different purposes of a Building. |
BuildingFurnitureClassValue |
BuildingFurnitureClassValue is a code list used to further classify a BuildingFurniture. |
BuildingFurnitureFunctionValue |
BuildingFurnitureFunctionValue is a code list that enumerates the different purposes of a BuildingFurniture. |
BuildingFurnitureUsageValue |
BuildingFurnitureUsageValue is a code list that enumerates the different uses of a BuildingFurniture. |
BuildingInstallationClassValue |
BuildingInstallationClassValue is a code list used to further classify a BuildingInstallation. |
BuildingInstallationFunctionValue |
BuildingInstallationFunctionValue is a code list that enumerates the different purposes of a BuildingInstallation. |
BuildingInstallationUsageValue |
BuildingInstallationUsageValue is a code list that enumerates the different uses of a BuildingInstallation. |
BuildingRoomClassValue |
BuildingRoomClassValue is a code list used to further classify a BuildingRoom. |
BuildingRoomFunctionValue |
BuildingRoomFunctionValue is a code list that enumerates the different purposes of a BuildingRoom. |
BuildingRoomUsageValue |
BuildingRoomUsageValue is a code list that enumerates the different uses of a BuildingRoom. |
BuildingSubdivisionClassValue |
BuildingSubdivisionClassValue is a code list used to further classify a BuildingSubdivision. |
BuildingSubdivisionFunctionValue |
BuildingSubdivisionFunctionValue is a code list that enumerates the different purposes of a BuildingSubdivision. |
BuildingSubdivisionUsageValue |
BuildingSubdivisionUsageValue is a code list that enumerates the different uses of a BuildingSubdivision. |
BuildingUsageValue |
BuildingUsageValue is a code list that enumerates the different uses of a Building. |
RoofTypeValue |
RoofTypeValue is a code list that enumerates different roof types. |
RoomElevationReferenceValue |
RoomElevationReferenceValue is a code list that enumerates the different elevation reference levels used to measure room heights. |
8.17.3. Additional Information
Additional information about the Building Module can be found in the OGC CityGML 3.0 Users Guide
8.18. Tunnel
Requirements Class |
|
http://www.opengis.net/spec/CityGML-1/3.0/req/req-class-tunnel |
|
Target type |
Implementation Specification |
Dependency |
|
Dependency |
|
The Tunnel module provides the representation of thematic and spatial aspects of tunnels. Tunnels are horizontal or sloping enclosed passage ways of a certain length, mainly underground or underwater. Tunnels are intended for passing obstacles such as mountains, waterways or other traffic routes by humans, animals or things.
Tunnels are represented in the UML model by the top-level feature type Tunnel, which is the main class of the Tunnel module. Tunnels can physically or functionally be subdivided into tunnel parts. In addition, tunnels can be decomposed into structural elements, such as walls, slabs, staircases, and beams.
The interior of tunnels is represented by hollow spaces. This allows a virtual accessibility of tunnels such as for driving through a tunnel, for simulating disaster management, or for presenting the light illumination within a tunnel.
Tunnels can contain installations and furniture. Installations are permanent parts of a tunnel that strongly affect the outer or inner appearance of the tunnel and that cannot be moved. Examples are stairs, railings, radiators or pipes. In contrast, furniture represents moveable objects inside a tunnel, like movable equipment in control areas.
Tunnels can be bounded by different types of surfaces. In this way, the outer structure of tunnels can be differentiated semantically into wall surfaces, roof surfaces, ground surfaces, outer floor surfaces, and outer ceiling surfaces, whereas the visible surface of hollow spaces can be structured into interior wall surfaces, floor surfaces, and ceiling surfaces. Furthermore, the openings of tunnels, i.e. windows and doors, can be represented including their corresponding surfaces.
The UML diagram of the Tunnel module is depicted in Figure 62. The Tunnel module inherits concepts from the Construction module (cf. Section 8.15). The Construction module defines objects that are common to all types of construction, such as the different surface types and the openings. A detailed discussion of the Requirements Class Tunnel can be found in the CityGML 3.0 Users Guide.
The ADE data types provided for the Tunnel module are illustrated in Figure 63.
The Code Lists provided for the Tunnel module are illustrated in Figure 64.
Table 70 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Tunnel module:
Space class |
Allowed space boundaries |
AbstractTunnel |
|
HollowSpace |
|
Tunnel |
|
TunnelConstructiveElement |
|
TunnelFurniture |
No boundaries allowed |
TunnelInstallation |
|
TunnelPart |
|
8.18.1. Requirements
The following requirement defines the rules governing implementation of the CityGML Tunnel Module as an Implementation Specification.
Requirement 45 |
/req/tunnel/classes |
For each UML class defined or referenced in the Tunnel Package: |
|
A |
The Implementation Specification SHALL contain an element which represents the same concept as that defined for the UML class. |
B |
The Implementation Specification SHALL represent associations with the same source, target, direction, roles, and multiplicities as those of the UML class. |
C |
The implementation Specification SHALL represent the attributes of the UML class including the name, definition, type, and multiplicity. |
D |
The implementation Specification SHALL represent the attributes of all superclasses of the UML class including the name, definition, type, and mutiplicity. |
E |
The implementation Specification SHALL represent the associations of all superclasses of the UML class including the source, target, direction, roles, and multiplicity. |
F |
The Implementation Specification SHALL specify how it observes all constraints the Conceptual Model imposes on the UML class. |
The implementation of this Module is further constrained by the following spatial boundary requirement:
Requirement 46 |
/req/tunnel/boundaries |
Table 70 lists the surfaces that are allowed as thematic surface boundaries of the space classes defined in the Tunnel module. An Implementation Specification SHALL NOT specify boundaries except as specified in Table 70 |
|
The use of extension capabilities by Tunnel elements is constrained by the following requirement:
Requirement 47 |
/req/tunnel/ade/use |
ADE element and property extensions SHALL NOT be used unless conformance with the ADE Requirements Class can be demonstrated. |
|
8.18.2. Class Definitions
Class |
Description |
Tunnel |
A Tunnel represents a horizontal or sloping enclosed passage way of a certain length, mainly underground or underwater. [cf. ISO 6707-1] |
AbstractTunnel |
AbstractTunnel is an abstract superclass representing the common attributes and associations of the classes Tunnel and TunnelPart. |
HollowSpace |
A HollowSpace is a space within a Tunnel or TunnelPart intended for certain functions (e.g. transport or passage ways, service rooms, emergency shelters). A HollowSpace is bounded physically and/or virtually (e.g. by ClosureSurfaces or GenericSurfaces). |
TunnelConstructiveElement |
A TunnelConstructiveElement is an element of a Tunnel which is essential from a structural point of view. Examples are walls, slabs, beams. |
TunnelFurniture |
A TunnelFurniture is an equipment for occupant use, usually not fixed to the tunnel. [cf. ISO 6707-1] |
TunnelInstallation |
A TunnelInstallation is a permanent part of a Tunnel (inside and/or outside) which does not have the significance of a TunnelPart. In contrast to TunnelConstructiveElement, a TunnelInstallation is not essential from a structural point of view. Examples are stairs, antennas or railings. |
TunnelPart |
A TunnelPart is a physical or functional subdivision of a Tunnel. It would be considered a Tunnel, if it were not part of a collection of other TunnelParts. |
Name |
Description |
ADEOfAbstractTunnel |
ADEOfAbstractTunnel acts as a hook to define properties within an ADE that are to be added to AbstractTunnel. |
ADEOfHollowSpace |
ADEOfHollowSpace acts as a hook to define properties within an ADE that are to be added to a HollowSpace. |
ADEOfTunnel |
ADEOfTunnel acts as a hook to define properties within an ADE that are to be added to a Tunnel. |
ADEOfTunnelConstructiveElement |
ADEOfTunnelConstructiveElement acts as a hook to define properties within an ADE that are to be added to a TunnelConstructiveElement. |
ADEOfTunnelFurniture |
ADEOfTunnelFurniture acts as a hook to define properties within an ADE that are to be added to a TunnelFurniture. |
ADEOfTunnelInstallation |
ADEOfTunnelInstallation acts as a hook to define properties within an ADE that are to be added to a TunnelInstallation. |
ADEOfTunnelPart |
ADEOfTunnelPart acts as a hook to define properties within an ADE that are to be added to a TunnelPart. |
Name |
Description |
HollowSpaceClassValue |
HollowSpaceClassValue is a code list used to further classify a HollowSpace. |
HollowSpaceFunctionValue |
HollowSpaceFunctionValue is a code list that enumerates the different purposes of a HollowSpace. |
HollowSpaceUsageValue |
HollowSpaceUsageValue is a code list that enumerates the different uses of a HollowSpace. |
TunnelClassValue |
TunnelClassValue is a code list used to further classify a Tunnel. |
TunnelConstructiveElementClassValue |
TunnelConstructiveElementClassValue is a code list used to further classify a TunnelConstructiveElement. |
TunnelConstructiveElementFunctionValue |
TunnelConstructiveElementFunctionValue is a code list that enumerates the different purposes of a TunnelConstructiveElement. |
TunnelConstructiveElementUsageValue |
TunnelConstructiveElementUsageValue is a code list that enumerates the different uses of a TunnelConstructiveElement. |
TunnelFunctionValue |
TunnelFunctionValue is a code list that enumerates the different purposes of a Tunnel. |
TunnelFurnitureClassValue |
TunnelFurnitureClassValue is a code list used to further classify a TunnelFurniture. |
TunnelFurnitureFunctionValue |
TunnelFurnitureFunctionValue is a code list that enumerates the different purposes of a TunnelFurniture. |
TunnelFurnitureUsageValue |
TunnelFurnitureUsageValue is a code list that enumerates the different uses of a TunnelFurniture. |
TunnelInstallationClassValue |
TunnelInstallationClassValue is a code list used to further classify a TunnelInstallation. |
TunnelInstallationFunctionValue |
TunnelInstallationFunctionValue is a code list that enumerates the different purposes of a TunnelInstallation. |
TunnelInstallationUsageValue |
TunnelInstallationUsageValue is a code list that enumerates the different uses of a TunnelInstallation. |
TunnelUsageValue |
TunnelUsageValue is a code list that enumerates the different uses of a Tunnel. |
8.18.3. Additional Information
Additional information about the Tunnel Module can be found in the OGC CityGML 3.0 Users Guide
9. CityGML Data Dictionary
The CityGML UML model is the normative definition of the CityGML Conceptual Model. The Data Dictionary tables in this section were software generated from the UML model. As such, this section provides a normative representation of the CityGML Conceptual Model.
An alternate representation can be found in the Conceptual Model in Chapter 8.
9.1. ISO Classes
The following classes are defined in ISO standards and used by the CityGML Conceptual Model.
9.1.1. Class AnyFeature (ISO 19109:2015)
AnyFeature |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.2. Class CV_DiscreteGridPointCoverage (ISO 19123:2005)
CV_DiscreteGridPointCoverage |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.3. Class DirectPosition (ISO 19107: 2003)
DirectPosition |
||||||
|
||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.4. Class GM_Object (ISO 19107: 2003)
GM_Object |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.5. Class GM_MultiCurve (ISO 19107: 2003)
GM_MultiCurve |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.6. Class GM_MultiPoint (ISO 19107:2003)
GM_MultiPoint |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.7. Class GM_MultiSurface (ISO 19107:2003)
GM_MultiSurface |
||||||
|
||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.8. Class GM_Point (ISO 19107:2003)
GM_Point |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.9. Class GM_Solid (ISO 19107:2003)
GM_Solid |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.10. Class GM_Surface (ISO 19107:2003)
GM_Surface |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.11. Class GM_Tin (ISO 19107:2003)
GM_Tin |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.12. Class GM_TriangulatedSurface (ISO 19107:2003)
GM_TriangulatedSurface |
||||||
|
||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.13. Class SC_CRS (ISO 19111:2019)
SC_CRS |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.1.14. Class TM_Position (ISO 19108:2006)
TM_Position |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attribute and role names have the stereotype «Property» |
9.2. Core
Description: |
The Core module defines the basic components of the CityGML data model. The Core module defines abstract base classes that define the core properties of more specialized thematic classes defined in other modules. The Core module also defines concrete classes that are common to other modules, for example basic data types. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.2.1. Classes
AbstractAppearance |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractCityObject |
|||||||||||||||||||||
|
|||||||||||||||||||||
|
|||||||||||||||||||||
|
|||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractDynamizer |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractFeature |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractFeatureWithLifespan |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractLogicalSpace |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractOccupiedSpace |
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractPhysicalSpace |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractPointCloud |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractSpace |
||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractSpaceBoundary |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractThematicSurface |
|||||||||||||||||||||
|
|||||||||||||||||||||
|
|||||||||||||||||||||
|
|||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractUnoccupiedSpace |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractVersion |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractVersionTransition |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Address |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
CityModel |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
CityObjectRelation |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
ClosureSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
ImplicitGeometry |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.2.2. Data Types
AbstractGenericAttribute
|
ADEOfAbstractAppearance
|
ADEOfAbstractCityObject
|
ADEOfAbstractDynamizer
|
ADEOfAbstractFeature
|
ADEOfAbstractFeatureWithLifespan
|
ADEOfAbstractLogicalSpace
|
ADEOfAbstractOccupiedSpace
|
ADEOfAbstractPhysicalSpace
|
ADEOfAbstractPointCloud
|
ADEOfAbstractSpace
|
ADEOfAbstractSpaceBoundary
|
ADEOfAbstractThematicSurface
|
ADEOfAbstractUnoccupiedSpace
|
ADEOfAbstractVersion
|
ADEOfAbstractVersionTransition
|
ADEOfAddress
|
ADEOfCityModel
|
ADEOfClosureSurface
|
ExternalReference
|
||||||||||||
|
||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Occupancy
|
||||||||||||
|
||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
QualifiedArea
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
QualifiedVolume
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
XALAddress
|
9.2.3. Basic Types
Code |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
DoubleBetween0and1 |
||||||||
|
DoubleBetween0and1List |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
DoubleList |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
DoubleOrNilReasonList |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
ID |
||||||
|
IntegerBetween0and3 |
||||||||
|
MeasureOrNilReasonList |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TransformationMatrix2x2 |
||||||||
|
TransformationMatrix3x4 |
||||||||
|
TransformationMatrix4x4 |
||||||||
|
9.2.4. Unions
CityModelMember |
||||||||||||||||||
|
||||||||||||||||||
|
DoubleOrNilReason |
||||
|
||||
NilReason |
|||||||||
|
|||||||||
|
9.2.5. Code Lists
IntervalValue |
||||
|
MimeTypeValue |
||||
|
NilReasonEnumeration |
||||
|
OccupantTypeValue |
||||
|
OtherRelationTypeValue |
||||
|
QualifiedAreaTypeValue |
||||
|
QualifiedVolumeTypeValue |
||||
|
RelationTypeValue |
||||
|
TemporalRelationTypeValue |
||||
|
TopologicalRelationTypeValue |
||||
|
9.2.6. Enumerations
RelativeToTerrain
|
||||||||||||
|
RelativeToWater
|
||||||||||||||
|
SpaceType
|
||||||||
|
9.3. Appearance
Description: |
The Appearance module supports the modelling of the observable surface properties of CityGML features in the form of textures and material. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.3.1. Classes
AbstractSurfaceData |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractTexture |
|||||||||||||||||||||
|
|||||||||||||||||||||
|
|||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Appearance |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
GeoreferencedTexture |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
ParameterizedTexture |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TextureAssociation |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
X3DMaterial |
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.3.2. Data Types
AbstractTextureParameterization
|
ADEOfAbstractSurfaceData
|
ADEOfAbstractTexture
|
ADEOfAppearance
|
ADEOfGeoreferencedTexture
|
ADEOfParameterizedTexture
|
ADEOfX3DMaterial
|
TexCoordGen
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TexCoordList
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.3.3. Basic Types
Color |
||||||||
|
ColorPlusOpacity |
||||||||
|
9.3.6. Enumerations
TextureType
|
||||||||
|
WrapMode
|
||||||||||||
|
9.4. CityFurniture
Description: |
The CityFurniture module supports representation of city furniture objects. City furniture objects are immovable objects like lanterns, traffic signs, advertising columns, benches, or bus stops that can be found in traffic areas, residential areas, on squares, or in built-up areas. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.4.1. Classes
CityFurniture |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.4.2. Data Types
ADEOfCityFurniture
|
9.4.5. Code Lists
CityFurnitureClassValue |
||||
|
CityFurnitureFunctionValue |
||||
|
CityFurnitureUsageValue |
||||
|
9.5. CityObjectGroup
Description: |
The CityObjectGroup module supports grouping of city objects. Arbitrary city objects may be aggregated in groups according to user-defined criteria. A group may be further classified by application-specific attributes. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.5.1. Classes
CityObjectGroup |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Role |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.5.2. Data Types
ADEOfCityObjectGroup
|
9.5.5. Code Lists
CityObjectGroupClassValue |
||||
|
CityObjectGroupFunctionValue |
||||
|
CityObjectGroupUsageValue |
||||
|
9.6. Dynamizer
Description: |
The Dynamizer module supports the injection of timeseries data for individual attributes of CityGML features. Timeseries data can either be retrieved from external Sensor APIs (e.g. OGC SensorThings API, OGC Sensor Observation Services, MQTT, proprietary platforms), external standardized timeseries files (e.g. OGC TimeseriesML or OGC Observations & Measurements), external tabulated files (e.g CSV) or can be represented inline as basic time-value pairs. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.6.1. Classes
AbstractAtomicTimeseries |
||||||||||||
|
||||||||||||
|
||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractTimeseries |
||||||||||||
|
||||||||||||
|
||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
CompositeTimeseries |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Dynamizer |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
GenericTimeseries |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
StandardFileTimeseries |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TabulatedFileTimeseries |
||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.6.2. Data Types
ADEOfAbstractAtomicTimeseries
|
ADEOfAbstractTimeseries
|
ADEOfCompositeTimeseries
|
ADEOfDynamizer
|
ADEOfGenericTimeseries
|
ADEOfStandardFileTimeseries
|
ADEOfTabulatedFileTimeseries
|
SensorConnection
|
||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TimeseriesComponent
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TimeValuePair
|
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.6.5. Code Lists
AuthenticationTypeValue |
||||
|
SensorConnectionTypeValue |
||||
|
StandardFileTypeValue |
||||
|
TabulatedFileTypeValue |
||||
|
9.6.6. Enumerations
TimeseriesTypeValue
|
||||||||||||||||||
|
9.7. Generics
Description: |
The Generics module supports application-specific extensions to the CityGML data model. These extensions may be used to model and exchange additional attributes and features not covered by the predefined thematic classes of CityGML. Generic extensions shall only be used if appropriate thematic classes or attributes are not provided by any other CityGML module. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.7.1. Classes
GenericLogicalSpace |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
GenericOccupiedSpace |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
GenericThematicSurface |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
GenericUnoccupiedSpace |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.7.2. Data Types
ADEOfGenericLogicalSpace
|
ADEOfGenericOccupiedSpace
|
ADEOfGenericThematicSurface
|
ADEOfGenericUnoccupiedSpace
|
CodeAttribute
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
DateAttribute
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
DoubleAttribute
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
GenericAttributeSet
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
IntAttribute
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
MeasureAttribute
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
StringAttribute
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
UriAttribute
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.7.5. Code Lists
GenericLogicalSpaceClassValue |
||||
|
GenericLogicalSpaceFunctionValue |
||||
|
GenericLogicalSpaceUsageValue |
||||
|
GenericOccupiedSpaceClassValue |
||||
|
GenericOccupiedSpaceFunctionValue |
||||
|
GenericOccupiedSpaceUsageValue |
||||
|
GenericThematicSurfaceClassValue |
||||
|
GenericThematicSurfaceFunctionValue |
||||
|
GenericThematicSurfaceUsageValue |
||||
|
GenericUnoccupiedSpaceClassValue |
||||
|
GenericUnoccupiedSpaceFunctionValue |
||||
|
GenericUnoccupiedSpaceUsageValue |
||||
|
9.8. LandUse
Description: |
The LandUse module supports representation of areas of the earth’s surface dedicated to a specific land use. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.8.1. Classes
LandUse |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.8.2. Data Types
ADEOfLandUse
|
9.8.5. Code Lists
LandUseClassValue |
||||
|
LandUseFunctionValue |
||||
|
LandUseUsageValue |
||||
|
9.9. PointCloud
Description: |
The PointCloud module supports representation of CityGML features by a collection of points. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.9.1. Classes
PointCloud |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.10. Relief
Description: |
The Relief module supports representation of the terrain. CityGML supports terrain representations at different levels of detail, reflecting different accuracies or resolutions. Terrain may be specified as a regular raster or grid, as a TIN, by break lines, and/or by mass points. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.10.1. Classes
AbstractReliefComponent |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BreaklineRelief |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
MassPointRelief |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
RasterRelief |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
ReliefFeature |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TINRelief |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.10.2. Data Types
ADEOfAbstractReliefComponent
|
ADEOfBreaklineRelief
|
ADEOfMassPointRelief
|
ADEOfRasterRelief
|
ADEOfReliefFeature
|
ADEOfTINRelief
|
9.11. Transportation
Description: |
The Transportation module supports representation of the transportation infrastructure. Transportation features include roads, tracks, waterways, railways, and squares. Transportation features may be represented as a network and/or as a collection of spaces or surface elements embedded in a three-dimensional space. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.11.1. Classes
AbstractTransportationSpace |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AuxiliaryTrafficArea |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AuxiliaryTrafficSpace |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
ClearanceSpace |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Hole |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
HoleSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Intersection |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Marking |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Railway |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Road |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Section |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Square |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Track |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TrafficArea |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TrafficSpace |
||||||||||||||||||||||||
|
||||||||||||||||||||||||
|
||||||||||||||||||||||||
|
||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Waterway |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.11.2. Data Types
ADEOfAbstractTransportationSpace
|
ADEOfAuxiliaryTrafficArea
|
ADEOfAuxiliaryTrafficSpace
|
ADEOfClearanceSpace
|
ADEOfHole
|
ADEOfHoleSurface
|
ADEOfIntersection
|
ADEOfMarking
|
ADEOfRailway
|
ADEOfRoad
|
ADEOfSection
|
ADEOfSquare
|
ADEOfTrack
|
ADEOfTrafficArea
|
ADEOfTrafficSpace
|
ADEOfWaterway
|
9.11.5. Code Lists
AuxiliaryTrafficAreaClassValue |
||||
|
AuxiliaryTrafficAreaFunctionValue |
||||
|
AuxiliaryTrafficAreaUsageValue |
||||
|
AuxiliaryTrafficSpaceClassValue |
||||
|
AuxiliaryTrafficSpaceFunctionValue |
||||
|
AuxiliaryTrafficSpaceUsageValue |
||||
|
ClearanceSpaceClassValue |
||||
|
HoleClassValue |
||||
|
IntersectionClassValue |
||||
|
MarkingClassValue |
||||
|
RailwayClassValue |
||||
|
RailwayFunctionValue |
||||
|
RailwayUsageValue |
||||
|
RoadClassValue |
||||
|
RoadFunctionValue |
||||
|
RoadUsageValue |
||||
|
SectionClassValue |
||||
|
SquareClassValue |
||||
|
SquareFunctionValue |
||||
|
SquareUsageValue |
||||
|
SurfaceMaterialValue |
||||
|
TrackClassValue |
||||
|
TrackFunctionValue |
||||
|
TrackUsageValue |
||||
|
TrafficAreaClassValue |
||||
|
TrafficAreaFunctionValue |
||||
|
TrafficAreaUsageValue |
||||
|
TrafficSpaceClassValue |
||||
|
TrafficSpaceFunctionValue |
||||
|
TrafficSpaceUsageValue |
||||
|
WaterwayClassValue |
||||
|
WaterwayFunctionValue |
||||
|
WaterwayUsageValue |
||||
|
9.11.6. Enumerations
GranularityValue
|
||||||
|
TrafficDirectionValue
|
||||||||
|
9.12. Vegetation
Description: |
The Vegetation module supports representation of vegetation objects with vegetation-specific thematic classes. CityGML’s vegetation model distinguishes between solitary vegetation objects like trees, and vegetation areas which represent biotopes like forests or other plant communities. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.12.1. Classes
AbstractVegetationObject |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
PlantCover |
||||||||||||||||||||||||
|
||||||||||||||||||||||||
|
||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
SolitaryVegetationObject |
|||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.12.2. Data Types
ADEOfAbstractVegetationObject
|
ADEOfPlantCover
|
ADEOfSolitaryVegetationObject
|
9.12.5. Code Lists
PlantCoverClassValue |
||||
|
PlantCoverFunctionValue |
||||
|
PlantCoverUsageValue |
||||
|
SolitaryVegetationObjectClassValue |
||||
|
SolitaryVegetationObjectFunctionValue |
||||
|
SolitaryVegetationObjectUsageValue |
||||
|
SpeciesValue |
||||
|
9.13. Versioning
Description: |
The Versioning module supports representation of multiple versions of CityGML features within a single CityGML model. In addition, also the version transitions and transactions that lead to the different versions can be represented. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.13.1. Classes
Version |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
VersionTransition |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.13.2. Data Types
ADEOfVersion
|
ADEOfVersionTransition
|
Transaction
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.13.6. Enumerations
TransactionTypeValue
|
||||||||
|
TransitionTypeValue
|
||||||||||||
|
9.14. WaterBody
Description: |
The WaterBody module supports representation of the thematic aspects and 3D geometry of rivers, canals, lakes, and basins. It does, however, not inherit any hydrological or other dynamic aspects of fluid flow. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.14.1. Classes
AbstractWaterBoundarySurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
WaterBody |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
WaterGroundSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
WaterSurface |
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.14.2. Data Types
ADEOfAbstractWaterBoundarySurface
|
ADEOfWaterBody
|
ADEOfWaterGroundSurface
|
ADEOfWaterSurface
|
9.14.5. Code Lists
WaterBodyClassValue |
||||
|
WaterBodyFunctionValue |
||||
|
WaterBodyUsageValue |
||||
|
WaterLevelValue |
||||
|
9.15. Construction
Description: |
The Construction module supports representation of key elements of different types of constructions. These key elements include construction surfaces (e.g floor and ceiling), windows and doors, constructive elements (e.g. beams and slabs), installations, and furniture. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.15.1. Classes
AbstractConstruction |
|||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractConstructionSurface |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractConstructiveElement |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractFillingElement |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractFillingSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractFurniture |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractInstallation |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
CeilingSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Door |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
DoorSurface |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
FloorSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
GroundSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
InteriorWallSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
OtherConstruction |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
OuterCeilingSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
OuterFloorSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
RoofSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
WallSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Window |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
WindowSurface |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.15.2. Data Types
ADEOfAbstractConstruction
|
ADEOfAbstractConstructionSurface
|
ADEOfAbstractConstructiveElement
|
ADEOfAbstractFillingElement
|
ADEOfAbstractFillingSurface
|
ADEOfAbstractFurniture
|
ADEOfAbstractInstallation
|
ADEOfCeilingSurface
|
ADEOfDoor
|
ADEOfDoorSurface
|
ADEOfFloorSurface
|
ADEOfGroundSurface
|
ADEOfInteriorWallSurface
|
ADEOfOtherConstruction
|
ADEOfOuterCeilingSurface
|
ADEOfOuterFloorSurface
|
ADEOfRoofSurface
|
ADEOfWallSurface
|
ADEOfWindow
|
ADEOfWindowSurface
|
ConstructionEvent
|
||||||||||||
|
||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Elevation
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Height
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.15.5. Code Lists
DoorClassValue |
||||
|
DoorFunctionValue |
||||
|
DoorUsageValue |
||||
|
ElevationReferenceValue |
||||
|
EventValue |
||||
|
OtherConstructionClassValue |
||||
|
OtherConstructionFunctionValue |
||||
|
OtherConstructionUsageValue |
||||
|
WindowClassValue |
||||
|
WindowFunctionValue |
||||
|
WindowUsageValue |
||||
|
9.15.6. Enumerations
ConditionOfConstructionValue
|
||||||||||||||
|
HeightStatusValue
|
||||||
|
RelationToConstruction
|
||||||||
|
9.16. Bridge
Description: |
The Bridge module supports representation of thematic and spatial aspects of bridges, bridge parts, bridge installations, and interior bridge structures. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.16.1. Classes
AbstractBridge |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Bridge |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BridgeConstructiveElement |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BridgeFurniture |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BridgeInstallation |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BridgePart |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BridgeRoom |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.16.2. Data Types
ADEOfAbstractBridge
|
ADEOfBridge
|
ADEOfBridgeConstructiveElement
|
ADEOfBridgeFurniture
|
ADEOfBridgeInstallation
|
ADEOfBridgePart
|
ADEOfBridgeRoom
|
9.16.5. Code Lists
BridgeClassValue |
||||
|
BridgeConstructiveElementClassValue |
||||
|
BridgeConstructiveElementFunctionValue |
||||
|
BridgeConstructiveElementUsageValue |
||||
|
BridgeFunctionValue |
||||
|
BridgeFurnitureClassValue |
||||
|
BridgeFurnitureFunctionValue |
||||
|
BridgeFurnitureUsageValue |
||||
|
BridgeInstallationClassValue |
||||
|
BridgeInstallationFunctionValue |
||||
|
BridgeInstallationUsageValue |
||||
|
BridgeRoomClassValue |
||||
|
BridgeRoomFunctionValue |
||||
|
BridgeRoomUsageValue |
||||
|
BridgeUsageValue |
||||
|
9.17. Building
Description: |
The Building module supports representation of thematic and spatial aspects of buildings, building parts, building installations, building subdivisions, and interior building structures. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.17.1. Classes
AbstractBuilding |
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
AbstractBuildingSubdivision |
|||||||||||||||||||||
|
|||||||||||||||||||||
|
|||||||||||||||||||||
|
|||||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Building |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BuildingConstructiveElement |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BuildingFurniture |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BuildingInstallation |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BuildingPart |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BuildingRoom |
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
|
||||||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
BuildingUnit |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Storey |
|||||||||
|
|||||||||
|
|||||||||
|
|||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.17.2. Data Types
ADEOfAbstractBuilding
|
ADEOfAbstractBuildingSubdivision
|
ADEOfBuilding
|
ADEOfBuildingConstructiveElement
|
ADEOfBuildingFurniture
|
ADEOfBuildingInstallation
|
ADEOfBuildingPart
|
ADEOfBuildingRoom
|
ADEOfBuildingUnit
|
ADEOfStorey
|
RoomHeight
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.17.5. Code Lists
BuildingClassValue |
||||
|
BuildingConstructiveElementClassValue |
||||
|
BuildingConstructiveElementFunctionValue |
||||
|
BuildingConstructiveElementUsageValue |
||||
|
BuildingFunctionValue |
||||
|
BuildingFurnitureClassValue |
||||
|
BuildingFurnitureFunctionValue |
||||
|
BuildingFurnitureUsageValue |
||||
|
BuildingInstallationClassValue |
||||
|
BuildingInstallationFunctionValue |
||||
|
BuildingInstallationUsageValue |
||||
|
BuildingRoomClassValue |
||||
|
BuildingRoomFunctionValue |
||||
|
BuildingRoomUsageValue |
||||
|
BuildingSubdivisionClassValue |
||||
|
BuildingSubdivisionFunctionValue |
||||
|
BuildingSubdivisionUsageValue |
||||
|
BuildingUsageValue |
||||
|
RoofTypeValue |
||||
|
RoomElevationReferenceValue |
||||
|
9.18. Tunnel
Description: |
The Tunnel module supports representation of thematic and spatial aspects of tunnels, tunnel parts, tunnel installations, and interior tunnel structures. |
Parent Package: |
CityGML |
Stereotype: |
«ApplicationSchema» |
9.18.1. Classes
AbstractTunnel |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
HollowSpace |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
Tunnel |
||||||
|
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TunnelConstructiveElement |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TunnelFurniture |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TunnelInstallation |
|||||||||||||||
|
|||||||||||||||
|
|||||||||||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
TunnelPart |
||||||
|
||||||
|
||||||
Note: Unless otherwise specified, all attributes and role names have the stereotype «Property». |
9.18.2. Data Types
ADEOfAbstractTunnel
|
ADEOfHollowSpace
|
ADEOfTunnel
|
ADEOfTunnelConstructiveElement
|
ADEOfTunnelFurniture
|
ADEOfTunnelInstallation
|
ADEOfTunnelPart
|
9.18.5. Code Lists
HollowSpaceClassValue |
||||
|
HollowSpaceFunctionValue |
||||
|
HollowSpaceUsageValue |
||||
|
TunnelClassValue |
||||
|
TunnelConstructiveElementClassValue |
||||
|
TunnelConstructiveElementFunctionValue |
||||
|
TunnelConstructiveElementUsageValue |
||||
|
TunnelFunctionValue |
||||
|
TunnelFurnitureClassValue |
||||
|
TunnelFurnitureFunctionValue |
||||
|
TunnelFurnitureUsageValue |
||||
|
TunnelInstallationClassValue |
||||
|
TunnelInstallationFunctionValue |
||||
|
TunnelInstallationUsageValue |
||||
|
TunnelUsageValue |
||||
|
10. Application Domain Extension (ADE)
An Application Domain Extension (ADE) is a formal and systematic extension of the CityGML Conceptual Model (CM) for a specific application or domain. The ADE is expressed in the form of a UML conceptual model. The domain data is mapped to a set of additional classes, attributes, and relations. ADEs may use elements from the CityGML CM to derive application-specific subclasses, to inject additional properties, to associate application data with predefined CityGML content, or to define value domains for attributes.
The ADE mechanism allows application-specific information to be aligned with the CityGML CM in a well-structured and systematic way. By this means, CityGML can be extended to meet the information needs of an application while at the same time preserving its concepts and semantic structures. Moreover, and in contrast to generic city objects and attributes, application data can be validated against the formal definition of an ADE to ensure semantic interoperability.
Previous versions of the CityGML Standard defined the ADE mechanism solely at the level of the XML Schema encoding. With CityGML 3.0, ADEs become platform-independent models at a conceptual level that can be mapped to multiple and different target encodings.
ADEs have successfully been implemented in practice and enable a wide range of applications and use cases based on the CityGML Standard. An overview and discussion of existing ADEs is provided in [Biljecki et al. 2018].
10.1. General Rules for ADEs
An ADE shall be defined as a UML conceptual model in accordance with the General Feature Model as specified in ISO 19109 and the rules and constraints for application schemas as specified in ISO 19103. The UML notations and stereotypes used in the CityGML conceptual model should also be applied to corresponding model elements in an ADE.
Every ADE shall be organized into one or more UML packages having globally unique namespaces and containing all UML model elements defined by the ADE. An ADE may additionally import and use predefined classes from external conceptual UML models such as the CityGML modules or the standardized schemas of the ISO 19100 series of International Standards.
10.2. Defining New ADE Model Elements
Following ISO 19109, the primary view of geospatial information and the core elements of application schemas is the feature. ADEs therefore typically extend CityGML by defining new feature types appropriate to the application area together with additional content such as object types, data types, code lists, and enumerations.
Every feature type in an ADE shall be derived either directly or indirectly from the CityGML root feature type Core::AbstractFeature or, depending on its type and characteristics, from a more appropriate subclass thereof. According to the general CityGML space concept, features representing spaces or space boundaries shall be derived either directly or indirectly from Core::AbstractSpace or Core::AbstractSpaceBoundary respectively. UML classes representing top-level feature types shall use the «TopLevelFeatureType» stereotype.
In contrast to feature types, object types and data types are not required to be derived from a predefined CityGML class unless explicitly stated otherwise.
ADE classes may have an unlimited number of attributes and associations in addition to those inherited from their parents. Attributes can be modelled with either simple or complex data types. To ensure semantic interoperability, the predefined types from CityGML or the standardized schemas of the ISO 19100 series of International Standards should be used wherever appropriate. This includes, amongst others, basic types from ISO/TS 19103, geometry and topology objects from ISO 10107, and temporal geometry and topology objects from ISO 19108.
If a predefined type is not available, ADEs can either define their own data types or import data types from external conceptual models. This explicitly includes the possibility of defining new geometry types not offered by ISO 19107. Designers of an ADE should however note that software might not be able to properly identify and consume such geometry types.
A feature type capturing a real-world feature with geometry should be derived either directly or indirectly from Core::AbstractSpace or Core::AbstractSpaceBoundary. By this means, the CityGML predefined spatial properties and the associated LOD concepts are inherited and available for the feature type. If, however, these superclasses are either inappropriate or lack a spatial property required to represent the feature, an ADE may define new and additional spatial properties. If such a spatial property should belong to one of the predefined LODs, then the property name shall start with the prefix “lodX”, where X is to be replaced by an integer value between 0 and 3 indicating the target LOD. This enables software to derive the LOD of the geometry.
Constraints on model elements should be expressed using a formal language such as the Object Constraint Language (OCL). The ADE specifies the manner of application of constraints. However, following the CityGML conceptual model, constraints should at least be expressed on ADE subclasses of Core::AbstractSpace to limit the types of space boundaries (i.e., instances of Core::AbstractSpaceBoundary) that may be used to model the boundary of a space object.
Illustrative examples for ADEs can be found in the CityGML 3.0 User Guide.
10.3. Augmenting CityGML Feature Types with Additional ADE Properties
If a predefined CityGML feature type lacks one or more properties required for a specific application, a feasible solution in CityGML 2.0 was to derive a new ADE feature type as subclass of the CityGML class and to add the properties to this subclass. While conceptually clean, this approach also faces drawbacks. If multiple ADEs require additional properties for the same CityGML feature type, this will lead to many subclasses of this feature type in different ADE namespaces. Information about the same real-world feature might therefore be spread over various instances of the different feature classes in an encoding making it difficult for software to consume the feature data.
For this reason, CityGML 3.0 provides a way to augment the predefined CityGML feature types with additional properties from the ADE domain without the need for subclassing. Each CityGML feature type has an extension attribute of name “adeOfFeatureTypeName” and type “ADEOfFeatureTypeName”, where FeatureTypeName is replaced by the class name in which the attribute is defined. For example, the Building::Building class offers the attribute adeOfBuilding of type Building::ADEOfBuilding. Each of these extension attributes can occur zero to unlimited times, and the attribute types are defined as abstract and empty data types.
If an ADE augments a specific CityGML feature type with additional ADE properties, the ADE shall create a subclass of the corresponding abstract data type associated with the feature class. This subclass shall also be defined as data type using the stereotype «DataType». The additional application-specific attributes and associations are then modelled as properties of the ADE subclass. This may include, amongst others, attributes with simple or complex data type, spatial properties or associations to other object and feature types from the ADE or external models such as CityGML.
The predefined “ADEOfFeatureTypeName” data types are called “hooks” because they are used as the head of a hierarchy of ADE subclasses attaching application-specific properties. When subclassing the “hook” of a specific CityGML feature type in an ADE, the properties defined in the subclass can be used for that feature type as well as for all directly or indirectly derived feature types, including feature types defined in the same or another ADE.
Multiple distinct ADEs can use the “hook” mechanism to define additional ADE properties for the same CityGML feature type. Since the “adeOfFeatureTypeName” attribute may occur multiple times, the various ADE properties can be exchanged as part of the same CityGML feature instance in an encoding. Software can therefore easily consume the default CityGML feature data plus the additional properties from the different ADEs.
Content from unknown or unsupported ADEs may be ignored by an application or service consuming an encoded CityGML model.
Designers of an ADE should favor using this “hook” mechanism over subclassing a CityGML feature type when possible. If an ADE must enable other ADEs to augment its own feature types (so-called ADE of an ADE), then it shall implement “hooks” for its feature types following the same schema and naming concept as in the CityGML conceptual model.
The UML fragment in Figure 66 shows an example for using the "hook" mechanism. For more details on this and other example ADEs, please see the CityGML 3.0 User Guide for an example ADE.
10.4. Encoding of ADEs
This document only addresses the conceptual modelling of ADEs. Rules and constraints for mapping a conceptual ADE model to a target encoding are expected to be defined in a corresponding CityGML Encoding Standard. If supported, an ADE may provide additional mapping rules and constraints in conformance with a corresponding CityGML Encoding Standard.
10.5. Requirements and Recommendations
The following requirements and recommendations specify how ADEs shall be used as an extension capability to the CityGML Conceptual Model.
Requirements Class |
|
Target type |
Conceptual Model |
Dependency |
|
10.5.1. UML
Any extension to the CityGML Conceptual Model should be a faithful continuation of the styles and techniques used in that model. The following Requirements and Recommendations define a "faithful continuation".
Requirement 48 |
/req/ade/uml |
An ADE SHALL be defined as conceptual model in UML in accordance with the conceptual modelling framework of the ISO 19100 series of International Standards |
|
A |
The UML model SHALL adhere to the General Feature Model as specified in ISO 19109. |
B |
The UML model SHALL adhere to rules and constraints for application schemas as specified in ISO/TS 19103. |
C |
Every ADE SHALL be organized into one or more UML packages having globally unique namespaces and containing all UML model elements defined by the ADE. |
Recommendation 1 |
/rec/ade/uml |
In addition to meeting the requirements for a CityGML ADE, an ADE should: |
|
A |
The UML notations and stereotypes used in the CityGML conceptual model SHOULD be applied to corresponding model elements in an ADE. |
B |
An ADE SHOULD import and use predefined classes from external conceptual UML models such as the CityGML modules or the standardized schemas of the ISO 19100 series of International Standards. |
10.5.2. Classes
The following Requirements and Recommendations define how CityGML classes should be extended by an ADE.
Requirement 49 |
/req/ade/elements |
ADEs typically extend CityGML by defining new Feature Types together with additional content such as Object Types, Data Types, Code Lists, and Enumerations. |
|
A |
Every Feature Type in an ADE SHALL be derived either directly or indirectly from the CityGML root Feature Type core:AbstractFeature or a subclass thereof. |
B |
UML classes representing Top-Level Feature Types SHALL use the «TopLevelFeatureType» stereotype. |
C |
Features representing spaces or space boundaries SHALL be derived either directly or indirectly from core:AbstractSpace or core:AbstractSpaceBoundary respectively. |
D |
An ADE may define new and additional spatial properties. If such a spatial property should belong to a predefined LOD, then the property name SHALL start with the prefix “lodX”, where X is an integer value indicating the target LOD. |
Recommendation 50 |
/rec/ade/elements |
ADEs typically extend CityGML by defining new feature types together with additional content such as object types, data types, code lists, and enumerations. |
|
A |
ADEs SHOULD use the predefined types from CityGML or the standardized schemas of the ISO 19100 series of International Standards. |
B |
Constraints on model elements SHOULD be expressed using a formal language such as the Object Constraint Language (OCL). |
C |
ADE subclasses of core:AbstractSpace SHOULD include constraints to limit the boundaries of the space object. |
10.5.3. Properties
The following Requirements define how to use the CityGML extension properties to add attributes to an existing CityGML Feature Type.
Requirement 51 |
/req/ade/properties |
Every Feature Type includes an extension property (hook) of type “ADEOf<FeatureTypeName>” where <FeatureTypeName> is the name of that Feature Type. To add an extension property to a Feature Type: |
|
A |
The ADE SHALL create a subclass of the abstract data type associated with the hook. |
B |
This subclass SHALL be defined as a data type using the stereotype «DataType». |
C |
Application-specific attributes and associations SHALL be modeled as properties of the ADE subclass. |
Annex A: Abstract Test Suite (Normative)
A.1. Introduction
CityGML 3.0 is a Conceptual Model. Since it is agnostic to implementing technologies, an Executable Test Script is not feasible. It becomes the responsibility of the Implementation Specifications to provide evidence of conformance. This evidence should be provided as an annex to the Implementation Specification document.
The test method specified in this ATS is manual inspection. Automated methods may be used where they exist.
A.2. Conformance Class Core
Abstract Test 1 |
/ats/core/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Core Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 2 |
/ats/Core/isorestrictions |
Test Purpose |
To validate that none of the restrictions which the CityGML Conceptual Model imposes on ISO classes are violated by an Implementation Specification. |
Requirement |
|
Test Method |
Manual Inspection |
A |
For each instance of the GM_Solid class, validate that there are no interior boundaries associated with that instance. |
B |
For each instance of a class descended from the GM_Solid class, validate that there are no interior boundaries associated with that instance. |
Abstract Test 3 |
/ats/core/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Core Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 4 |
/ats/core/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Core Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.3. Conformance Class Appearance
Abstract Test 5 |
/ats/appearance/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Appearance Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 6 |
/ats/appearance/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Appearance Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.4. Conformance Class CityFurniture
Abstract Test 7 |
/ats/cityfurniture/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the CityFurniture Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 8 |
/ats/cityfurniture/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the CityFurniture Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 9 |
/ats/cityfurniture/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the CityFurniture Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.5. Conformance Class CityObjectGroup
Abstract Test 10 |
/ats/cityobjectgroup/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the CityObjectGroup Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 11 |
/ats/cityobjectgroup/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the CityObjectGroup Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 12 |
/ats/cityobjectgroup/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the CityObjectGroup Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.6. Conformance Class Dynamizer
Abstract Test 13 |
/ats/dynamizer/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Dynamizer Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 14 |
/ats/dynamizer/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Dynamizer Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.7. Conformance Class Generics
Abstract Test 15 |
/ats/generics/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Generics Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 16 |
/ats/generics/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Generics Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 17 |
/ats/generics/use |
Test Purpose |
To validate that Generics are not used in a way that duplicates or confilcts with feature classes or attributes defined in the Conceptual Model.. |
Requirement |
|
Test Method |
Manual Inspection |
For all Generics-based classes and attributes defined in the Implementation Specification: |
|
A |
Demonstrate that this class or attribue does not duplicate or conflict with any classes or attributes defined in the Conceptual Model. |
Abstract Test 18 |
/ats/generics/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Generics Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.8. Conformance Class LandUse
Abstract Test 19 |
/ats/landuse/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the LandUse Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 20 |
/ats/landuse/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the LandUse Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.9. Conformance Class PointCloud
Abstract Test 21 |
/ats/pointcloud/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the PointCloud Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 22 |
/ats/pointcloud/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the PointCloud Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.10. Conformance Class Relief
Abstract Test 23 |
/ats/relief/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Relief Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 24 |
/ats/relief/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Relief Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.11. Conformance Class Transportation
Abstract Test 25 |
/ats/transportation/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Transportation Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 26 |
/ats/transportation/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Transportation Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 27 |
/ats/transportation/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Transportation Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.12. Conformance Class Vegetation
Abstract Test 28 |
/ats/vegetation/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Vegetation Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 29 |
/ats/vegetation/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Vegetation Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 30 |
/ats/vegetation/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Vegetation Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.13. Conformance Class Versioning
Abstract Test 31 |
/ats/versioning/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Versioning Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 32 |
/ats/versioning/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Versioning Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.14. Conformance Class WaterBody
Abstract Test 33 |
/ats/waterbody/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Waterbody Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 34 |
/ats/waterbody/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Waterbody Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 35 |
/ats/waterbody/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Waterbody Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.15. Conformance Class Construction
Abstract Test 36 |
/ats/construction/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Construction Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 37 |
/ats/construction/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Construction Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 38 |
/ats/construction/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Construction Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.16. Conformance Class Bridge
Abstract Test 39 |
/ats/bridge/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Bridge Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 40 |
/ats/bridge/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Bridge Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 41 |
/ats/bridge/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Bridge Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.17. Conformance Class Building
Abstract Test 42 |
/ats/building/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Building Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 43 |
/ats/building/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Building Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 44 |
/ats/building/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Building Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.18. Conformance Class Tunnel
Abstract Test 45 |
/ats/tunnel/classes |
Test Purpose |
To validate that the Implementation Specification correctly implements the UML Classes defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Tunnel Package: |
|
A |
Validate that the Implementation Specification contains a data element which represents the same concept as that defined for the UML class. |
B |
Validate that the data element has the same relationships with other elements as those defined for the UML class. Validate that those relationships have the same source, target, direction, roles, and multiplicies as those documented in the Conceptual Model. |
C |
Validate that the data element has the same properties (attributes) as those specified for the UML class. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model. |
D |
Validate that the properties of the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those properties have the same name, definition, type, and multiplicity of those documented in the Conceptual Model |
E |
Validate that the associations represented for the data element include those of all superclasses of the UML class as documented in the Conceptual Model. Validate that those representations have the same source, target, roles, and multiplicity of those documented in the Conceptual Model |
F |
Validate that the Implementation Specification enforces all constraints imposed on the UML class by the Conceptual Model |
Abstract Test 46 |
/ats/tunnel/boundaries |
Test Purpose |
To validate that the Implementation Specification does not specify boundaries except as defined in the Conceptual Model. |
Requirement |
|
Test Method |
Manual Inspection |
For each UML class defined or referenced in the Tunnel Package: |
|
A |
Validate that the Implementation Specification does not specify boundaries for the UML class except as specified in the Conceptual Model. |
Abstract Test 47 |
/ats/tunnel/ade/use |
Test Purpose |
To validate that Application Data Extensions are not used unless conformance with the ADE Requirements Class can be demonstrated. |
Requirement |
|
Test Method |
Manual Inspection |
If any ADE classes or properties are included in the Tunnel Package: |
|
A |
Validate that the Implementation Specification conforms with the ADE Requirements Class. |
A.19. Conformance Class ADE
Abstract Test 48 |
/ats/ade/uml |
Test Purpose |
To validate that Application Domain Extensions (ADE) to the CityGML Conceptual Model are modeled correctly in UML. |
Requirement |
|
Test Method |
Manual Inspection |
An ADE is defined as conceptual model in UML in accordance with the conceptual modelling framework of the ISO 19100 series of International Standards |
|
A |
Validate that the ADE UML model adheres to the General Feature Model as specified in ISO 19109. |
B |
Validate that the ADE UML model adheres to rules and constraints for application schemas as specified in ISO/TS 19103. |
C |
Validate that the ADE UML model is organized into one or more UML packages having globally unique namespaces and containing all UML model elements defined by the ADE. |
Abstract Test 49 |
/ats/ade/elements |
Test Purpose |
To validate that Application Domain Extension s (ADE) to the CityGML Conceptual Model are implemented correctly. |
Requirement |
|
Test Method |
Manual Inspection |
For each new UML class defined by an ADE: |
|
A |
Validate that every Feature Type class in an ADE is derived either directly or indirectly from the CityGML root Feature Type core:AbstractFeature or a subclass thereof. |
B |
Validate that every UML class in an ADE which represents a top-level Feature Type is assigned the «TopLevelFeatureType» stereotype. |
C |
Validate that every UML class in an ADE which represents spaces or space boundaries is derived either directly or indirectly from core:AbstractSpace or core:AbstractSpaceBoundary respectively. |
D |
Validate that any new or additional spatial properties defined by an ADE:
|
Abstract Test 50 |
/ats/ade/properties |
Test Purpose |
To validate that Application Domain Extension s (ADE) to the CityGML Conceptual Model implement extension properties correctly. |
Requirement |
|
Test Method |
Manual Inspection |
Every Feature Type in the CityGML Conceptual Model includes an extension property whos' purpose is to allow an ADE to add properties to that existing Feature Type. In every case where an extension property has been used: |
|
A |
Validate that the ADE creates a subclass of the abstract data type associated with the extension property. |
B |
Validate that this subclass is defined as a data type using the stereotype «DataType». |
C |
Validate that all application-specific attributes and associations for that Feature Type are modeled as properties of the ADE subclass. |
Annex B: Revision History
| Date | Release | Editor | Primary clauses modified | Description |
|---|---|---|---|---|
2020-06-04 |
0.9.0 |
C. Heazel |
all |
Draft for review |
2020-06-07 |
0.9.1 |
T. H. Kolbe |
Chapter 10 |
Bibliography was added |
2020-06-08 |
0.9.2 |
C. Nagel |
Chapter 10 |
Chapter on ADE mechanism was added |
2020-06-11 |
0.9.3 |
T. H. Kolbe |
Chapter 7 |
Overview chapter on CityGML was added |
2020-06-11 |
0.9.4 |
T. Kutzner |
Chapter 0 |
List of participants and submitters was added |
2020-08-05 |
0.9.5 |
T. Kutzner |
Chapter 8 |
Boundary constraints were added |
2020-08-05 |
0.9.6 |
C. Heazel, T. Kutzner |
Chapter 8 |
UML update |
Annex C: Glossary
conformance test class
set of conformance test modules that must be applied to receive a single certificate of
conformance
[OGC 08-131r3, definition 4.4]
feature
abstraction of real world phenomena
[ISO 19101-1:2014, definition 4.1.11]
feature attribute
characteristic of a feature
[ISO 19101-1:2014, definition 4.1.12]
feature type
class of features having common characteristics
[ISO 19156:2011, definition 4.7]
measurement
set of operations having the object of determining the value of a quantity
[ISO 19101-2:2018, definition 3.21] / [VIM:1993, 2.1]
model
abstraction of some aspects of reality
[ISO 19109:2015, definition 4.15]
observation
act of measuring or otherwise determining the value of a property
[ISO 19156:2011, definition 4.11]
observation procedure
method, algorithm or instrument, or system of these, which may be used in making an
observation
[ISO 19156:2011, 4.12]
observation result
estimate of the value of a property determined through a known observation procedure
[ISO 19156:2011, 4.14]
property
facet or attribute of an object referenced by a name.
[ISO 19143:2010, definition 4.21]
requirements class
aggregate of all requirement modules that must all be satisfied to satisfy a conformance
test class
[OGC 08-131r3, definition 4.19]
schema
formal description of a model
[ISO 19101-1:2014, definition 4.1.34]
sensor
type of observation procedure that provides the estimated value of an observed
property at its output
[OGC 08-094r1, definition 4.5]
Standardization Target
TBD
timeseries
sequence of data values which are ordered in time
[OGC 15-043r3]
universe of discourse
view of the real or hypothetical world that includes everything of interest
[ISO 19101-1:2014, definition 4.1.38]
version
Particular variation of a spatial object
[INSPIRE Glossary]
C.1. ISO Concepts
The following concepts from the ISO TC211 Harmonized UML model are referenced by the CityGML Conceptual UML model but do not play a major role in its' definition. They are provided here to support a more complete understanding of the model.
Area
The measure of the physical extent of any topologically 2-D geometric object. Usually measured in "square" units of length.
[ISO 19103:2015]
Boolean
boolean is the mathematical datatype associated with two-valued logic
[ISO 19103:2015]
CC_CoordinateOperation
mathematical operation on coordinates that transforms or converts coordinates to another coordinate reference system.
[ISO 19111:2019]
Character
symbol from a standard character-set.
[ISO 19103:2015]
CharacterString
Characterstring is a family of datatypes which represent strings of symbols from standard character-sets.
[ISO 19103:2015]
CRS
Coordinate reference system which is usually single but may be compound.
[ISO 19111:2019]
CV_DiscreteCoverage
A subclass of CV_Coverage that returns a single record of values for any direct position within a single geometric object in its spatiotemporal domain.
[ISO 19123:2005]
CV_DomainObject
[ISO 19123:2005]
CV_GridPointValuePair
[ISO 19123:2005]
CV_GridValuesMatrix
The geometry represented by the various offset vectors is in the image plane of the grid.
[ISO 19123:2005]
CV_ReferenceableGrid
[ISO 19123:2005]
Date
[ISO 19103:2015]
DateTime
[ISO 19103:2015]
Distance
Used as a type for returning distances and possibly lengths.
[ISO 19103:2015]
Engineering CRS
A contextually local coordinate reference system which can be divided into two broad categories:
-
earth-fixed systems applied to engineering activities on or near the surface of the earth;
-
CRSs on moving platforms such as road vehicles, vessels, aircraft or spacecraft.
[ISO 19111:2019]
Generic Name
Generic Name is the abstract class for all names in a NameSpace. Each instance of a GenericName is either a LocalName or a ScopedName.
[ISO 19103:2015]
Geometry
[ISO 19107:2003]
GM_CompositePoint
[ISO 19107:2003]
GM_CompositeSolid
set of geometric solids adjoining one another along common boundary geometric surfaces
[ISO 19107:2003]
GM_GenericSurface
GM_Surface and GM_SurfacePatch both represent sections of surface geometry, and therefore share a number of operation signatures. These are defined in the interface class GM_GenericSurface.
[ISO 19107:2003]
GM_LineString
consists of sequence of line segments, each having a parameterization like the one for GM_LineSegment
[ISO 19107:2003]
GM_MultiPrimitive
[ISO 19107:2003]
GM_OrientableSurface
a surface and an orientation inherited from GM_OrientablePrimitive. If the orientation is "+", then the GM_OrientableSurface is a GM_Surface. If the orientation is "-", then the GM_OrientableSurface is a reference to a GM_Surface with an upNormal that reverses the direction for this GM_OrientableSurface, the sense of "the top of the surface".
[ISO 19107:2003]
GM_PolyhedralSurface
a GM_Surface composed of polygon surfaces (GM_Polygon) connected along their common boundary curves.
[ISO 19107:2003]
GM_Position
a union type consisting of either a DirectPosition or of a reference to a GM_Point from which a DirectPosition shall be obtained.
[ISO 19107:2003]
GM_Primitive
The abstract root class of the geometric primitives. Its main purpose is to define the basic "boundary" operation that ties the primitives in each dimension together.
[ISO 19107:2003]
Integer
An exact integer value, with no fractional part.
[ISO 19103:2015]
Internet of Things
The network of physical objects--“things”--that are embedded with sensors, software, and other technologies for the purpose of connecting and exchanging data with other devices and systems over the Internet.
Wikipedia
IO_IdentifiedObjectBase
[ISO 19103:2015]
Length
The measure of distance as an integral, i.e. the limit of an infinite sum of distances between points on a curve.
[ISO 19103:2015]
Measure
The result from performing the act or process of ascertaining the extent, dimensions, or quantity of some entity.
[ISO 19103:2015]
Number
The base type for all number data, giving the basic algebraic operations.
[ISO 19103:2015]
Point
GM_Point is the basic data type for a geometric object consisting of one and only one point.
[ISO 19107:2003]
Real
The common binary Real finite implementation using base 2.
[ISO 19103:2015]
RS_ReferenceSystem
Description of a spatial and temporal reference system used by a dataset.
[ISO 19111:2019]
Scoped Name
ScopedName is a composite of a LocalName for locating another NameSpace and a GenericName valid in that NameSpace. ScopedName contains a LocalName as head and a GenericName, which might be a LocalName or a ScopedName, as tail.
[ISO 19103:2015]
Solid
GM_Solid, a subclass of GM_Primitive, is the basis for 3-dimensional geometry. The extent of a solid is defined by the boundary surfaces.
[ISO 19107:2003]
Time
[ISO 19103:2015]
TM_Duration
[ISO 19108:2006]
TM_TemporalPosition
The position of a TM_Instant relative to a TM_ReferenceSystem.
[ISO 19108:2006]
Unit of Measure
Any of the systems devised to measure some physical quantity such distance or area or a system devised to measure such things as the passage of time.
[ISO 19103:2015]
URI
Uniform Resource Identifier (URI), is a compact string of characters used to identify or name a resource
[ISO 19103:2015]
Volume
[ISO 19103:2015]
C.2. Abbreviated Terms
-
2D Two Dimensional
-
3D Three Dimensional
-
AEC Architecture, Engineering, Construction
-
ALKIS German National Standard for Cadastral Information
-
ATKIS German National Standard for Topographic and Cartographic Information
-
BIM Building Information Modeling
-
B-Rep Boundary Representation
-
bSI buildingSMART International
-
CAD Computer Aided Design
-
COLLADA Collaborative Design Activity
-
CSG Constructive Solid Geometry
-
DTM Digital Terrain Model
-
DXF Drawing Exchange Format
-
EuroSDR European Spatial Data Research Organisation
-
ESRI Environmental Systems Research Institute
-
FM Facility Management
-
GDF Geographic Data Files
-
GDI-DE Spatial Data Infrastructure Germany (Geodateninfrastruktur Deutschland)
-
GDI NRW Geodata Infrastructure North-Rhine Westphalia
-
GML Geography Markup Language
-
IAI International Alliance for Interoperability (now buildingSMART International (bSI))
-
IETF Internet Engineering Task Force
-
IFC Industry Foundation Classes
-
IoT Internet of Things
-
ISO International Organization for Standardisation
-
ISO/TC211 ISO Technical Committee 211
-
LOD Levels of Detail
-
MQTT
-
NBIMS National Building Information Model Standard
-
OASIS Organisation for the Advancement of Structured Information Standards
-
OGC Open Geospatial Consortium
-
OSCRE Open Standards Consortium for Real Estate
-
SIG 3D Special Interest Group 3D of the GDI-DE
-
TIC Terrain Intersection Curve
-
TIN Triangulated Irregular Network
-
UML Unified Modeling Language
-
URI Uniform Resource Identifier
-
VRML Virtual Reality Modeling Language
-
W3C World Wide Web Consortium
-
W3DS OGC Web 3D Service
-
WFS OGC Web Feature Service
-
X3D Open Standards XML-enabled 3D file format of the Web 3D Consortium
-
XML Extensible Markup Language
-
xAL OASIS extensible Address Language
Annex D: Bibliography
-
Open Geospatial Consortium: The Specification Model — A Standard for Modular specifications, OGC 08-131
-
Agugiaro, G., Benner, J., Cipriano, P., Nouvel, R., 2018: The Energy Application Domain Extension for CityGML: enhancing interoperability for urban energy simulations. Open Geospatial Data, Software and Standards, Vol. 3. https://doi.org/10.1186/s40965-018-0042-y
-
Becker, T., Nagel, C., Kolbe, T. H., 2011: Integrated 3D Modeling of Multi-utility Networks and their Interdependencies for Critical Infrastructure Analysis. In: T. H. Kolbe, G. König, C. Nagel (Eds.): Advances in 3D Geoinformation Sciences. LNG&C, Springer, Berlin. https://doi.org/10.1007/978-3-642-12670-3_1
-
Beil, C., Kolbe, T. H., 2017: CityGML and the streets of New York - A proposal for detailed street space modelling. In: Proceedings of the 12th International 3D GeoInfo Conference 2017, ISPRS Annals of the Photogrammetry, Remote Sensing and Spatial Information Sciences, Vol. IV-4/W5, ISPRS. http://doi.org/10.5194/isprs-annals-IV-4-W5-9-2017
-
Biljecki, F., Stoter, J., Ledoux, H., Zlatanova, S., Çöltekin, A., 2015: Applications of 3D City Models: State of the Art Review. ISPRS International Journal of Geo-Information, 4(4). https://doi.org/10.3390/ijgi4042842
-
Biljecki, F., Kumar, K., Nagel, C., 2018: CityGML Application Domain Extension (ADE): overview of developments. Open Geospatial Data, Software and Standards, 3(1). https://doi.org/10.1186/s40965-018-0055-6
-
Billen, R., Zaki, C. E., Servières, M., Moreau, G., Hallot, P., 2012: Developing an ontology of space: Application to 3D city modeling. In: Leduc, T., Moreau, G., Billen, R. (eds): Usage, usability, and utility of 3D city models — European COST Action TU0801, EDP Sciences, Nantes, Vol. 02007. https://hal.archives-ouvertes.fr/hal-01521445
-
Chaturvedi, K., Smyth, C. S., Gesquière, G., Kutzner, T., Kolbe, T. H., 2015: Managing versions and history within semantic 3D city models for the next generation of CityGML. In: Selected papers from the 10th International 3DGeoInfo Conference 2015 in Kuala Lumpur, Malaysia, Springer LNG&C, Berlin. https://doi.org/10.1007/978-3-319-25691-7_11
-
Chaturvedi, K., Kolbe, T. H., 2016: Integrating Dynamic Data and Sensors with Semantic 3D City Models in the context of Smart Cities. In: Proceedings of the 11th International 3D Geoinfo Conference, ISPRS Annals of the Photogrammetry, Remote Sensing and Spatial Information Sciences, Vol. IV-2/W1, ISPRS. https://doi.org/10.5194/isprs-annals-IV-2-W1-31-2016
-
Chaturvedi, K., Kolbe, T. H., 2017: Future City Pilot 1 Engineering Report, Open Geospatial Consortium. OGC Doc. 19-098
-
Chaturvedi, K., Kolbe, T. H., 2019: A Requirement Analysis on Extending Semantic 3D City Models for Supporting Time-dependent Properties. In: Proceedings of the 4th International Conference on Smart Data and Smart Cities, ISPRS Annals of the Photogrammetry, Remote Sensing and Spatial Information Sciences, Vol. IV-4/W9, ISPRS. https://doi.org/10.5194/isprs-annals-IV-4-W9-19-2019
-
Elfes, A., 1989: Using occupancy grids for mobile robot perception and navigation. Computer 22(6):46–57. https://doi.org/10.1109/2.30720
-
Foley, J., van Dam, A., Feiner, S., Hughes, J., 2002: Computer Graphics: Principles and Practice. 2nd ed., Addison Wesley
-
Gröger, G., Plümer, L., 2012: CityGML – Interoperable semantic 3D city models. ISPRS Journal of Photogrammetry and Remote Sensing, Vol. 71, July 2012. https://dx.doi.org/10.1016/j.isprsjprs.2012.04.004
-
Gröger, G., Kolbe, T. H., Nagel, C., Häfele, K.-H., 2012: OGC City Geography Markup Language (CityGML) Encoding Standard, Version 2.0.0, Open Geospatial Consortium. OGC Doc. 12-019
-
Jensen, Christian S. and Dyreson, Curtis E.: The Consensus Glossary of Temporal Database Concepts. February 1998 Version. In: Temporal Databases: Research and Practice [online]. Springer Berlin Heidelberg, 1998. p. 367–405. Lecture Notes in Computer Science. Available from: 10.1007/BFb0053710
-
Jensen, Christian S. and Snodgrass, Richard T., eds.: TR-90, Temporal Database Entries for the Springer Encyclopedia of Database Systems. Technical Report. TimeCenter, 22 May 2008. Available from: http://timecenter.cs.aau.dk/TimeCenterPublications/TR-90.pdf
-
Johnson, Tom: Bitemporal Data. Elsevier, 2014. ISBN 978-0-12-408067-6. Available from: 10.1016/C2012-0-06609-4
-
Kaden, R., Clemen, C., 2017: Applying Geodetic Coordinate Reference Systems within Building Information Modeling (BIM). In: Proceedings of the FIG Working Week 2017, Helsinki, Finland. https://www.fig.net/resources/proceedings/fig_proceedings/fig2017/papers/ts06h/TS06H_kaden_clemen_8967.pdf
-
Kolbe, T. H., Gröger, G., 2003: Towards unified 3D city models. In: Proceedings of the Joint ISPRS Commission IV Workshop on Challenges in Geospatial Analysis, Integration and Visualization II, Stuttgart, Germany. https://mediatum.ub.tum.de/doc/1145769/
-
Kolbe, T. H., 2009: Representing and Exchanging 3D City Models with CityGML. In: J. Lee, S. Zlatanova (Eds.), 3D Geo-Information Sciences, Selected Papers of the 3rd International Workshop on 3D Geo-Information in Seoul, Korea. Springer, Berlin. https://doi.org/10.1007/978-3-540-87395-2_2
-
Konde, A., Tauscher, H., Biljecki, F., Crawford, J., 2018: Floor plans in CityGML. In: Proceedings of the 13th 3D GeoInfo Conference 2018, ISPRS Annals of the Photogrammetry, Remote Sensing and Spatial Information Sciences, Vol. IV-4/W6, 25–32, ISPRS. https://doi.org/10.5194/isprs-annals-IV-4-W6-25-2018
-
Kutzner, T., Hijazi, I., Kolbe, T. H., 2018: Semantic Modelling of 3D Multi-utility Networks for Urban Analyses and Simulations – The CityGML Utility Network ADE. International Journal of 3-D Information Modeling (IJ3DIM) 7(2), 1-34. https://dx.doi.org/10.4018/IJ3DIM.2018040101
-
Kutzner, T., Chaturvedi, K. & Kolbe, T. H., 2020: CityGML 3.0: New Functions Open Up New Applications. PFG - Journal of Photogrammetry, Remote Sensing and Geoinformation Science, 88, 43–61. https://doi.org/10.1007/s41064-020-00095-z
-
Labetski, A., van Gerwen, S., Tamminga, G., Ledoux, H., Stoter, J., 2018: A proposal for an improved transportation model in CityGML. In: Proceedings of the 13th 3D GeoInfo Conference 2018, ISPRS Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences, Vol. XLII-4/W10, 89–96. https://doi.org/10.5194/isprs-archives-XLII-4-W10-89-2018
-
Liu, Ling and Özsu, M. Tamer, eds.: Encyclopedia of Database Systems. New York, NY : Springer New York, 2018. ISBN 978-1-4614-8266-6. Available from: 10.1007/978-1-4614-8265-9
-
Löwner, M.-O., Gröger, G., Benner, J., Biljecki, F., Nagel, C., 2016: Proposal for a new LOD and multi-representation concept for CityGML. In: Proceedings of the 11th 3D Geoinfo Conference 2016, ISPRS Annals of the Photogrammetry, Remote Sensing and Spatial Information Sciences, Vol. IV-2/W1, 3–12. https://doi.org/10.5194/isprs-annals-IV-2-W1-3-2016
-
Nouvel, R., Bahu, J. M., Kaden, R., Kaempf, J., Cipriano, P., Lauster, M., Haefele, K.-H., Munoz, E., Tournaire, O, Casper, E., 2015: Development of the CityGML Application Domain Extension Energy for Urban Energy Simulation. In: Proceedings of Building Simulation 2015 - 14th Conference of the International Building Performance Simulation Association, IBPSA, 559-564. http://www.ibpsa.org/proceedings/BS2015/p2863.pdf
-
Smith, B., Varzi, A. C., 2000: Fiat and Bona Fide Boundaries. Philosophy and Phenomenological Research, Vol. 60, No. 2, 401-420. https://doi.org/10.2307/2653492
-
Snodgrass, Richard T: Developing time-oriented database applications in SQL. San Francisco, California : Morgan Kaufmann Publishers, July 1999. ISBN 1-55860-436-7. Available from: http://www.cs.arizona.edu/rts/tdbbook.pdf[http://www.cs.arizona.edu/rts/tdbbook.pdf]
-
Stadler, A., Kolbe, T. H., 2007: Spatio-semantic Coherence in the Integration of 3D City Models. In: Proceedings of the 5th International ISPRS Symposium on Spatial Data Quality ISSDQ 2007 in Enschede. http://www.isprs.org/proceedings/XXXVI/2-C43/Session1/paper_Stadler.pdf
-
Vretanos, P. A. 2010: OpenGIS Web Feature Service 2.0 Interface Standard, Open Geospatial Consortium. OGC Doc. 09-025r1
-
OASIS MQTT Technical Committee: MQTT Version 5.0 Standard, OASIS, March 7, 2019, Available from OASIS.